Vuncloud Blog
← Zurück zu den Entwicklernotizen

OpenAI Agents API in der Praxis: Agent bauen, in die Cloud legen, API- und Serverkosten rechnen

Drei Rechnungszeilen · eine Sitzung · ein Blatt zum EinsetzenEtwa 12 Minuten

Eine Person tippt Code auf einem Laptop neben einer Tasse, zum Bauen eines OpenAI-Agenten und zum Prüfen von API- und Serverkosten

Die Agents API von OpenAI ist am 10. September 2026 in die öffentliche Beta gegangen. Sie wählen Modell, Werkzeuge und Umgebung. OpenAI hostet den Harness, der Codex antreibt. Die API selbst hat keine Plattformgebühr. Eine Rechnung hat meist drei Zeilen: Modell-Token, eingebaute Werkzeuge und Containerzeit nur dann, wenn Sie die gehostete Sandbox wirklich nutzen. Braucht der Job xcodebuild, einen Simulator oder Signierung, kann das eine Linux-Sandbox nicht. Dafür brauchen Sie einen Mac, der wach bleibt.

Heute ist DevDay (29. September 2026, San Francisco). Die Sätze unten stammen von der Preisseite, der Modellseite zu GPT-6 Astra und der Ankündigung der Agents API, wie sie beim Schreiben offen waren. Ändert die Keynote einen Preis, gelten Konsole und Preisseite. Die Funktionskarte steht in der DevDay-Vorschau und bei Funktionen und Preisen von GPT-6 Astra.

$0
Plattformgebühr der Agents API
$10 / $50
Astra, kurzer Kontext, je 1 Mio. Token
$101.7
M4 16GB, Monat ab, Startseite

Die Rechnung in drei Zeilen teilen

„Der Agent ist teuer“ addiert oft vier verschiedene Dinge: ein Flaggschiff-Modell, Suche, einen leerlaufenden Container und eine Maschine, die Sie nur wegen macOS mieten. Getrennt liegt der teure Teil der täglichen Schleife in der Modellstufe, nicht darin, dass Sie die Agents API aufgerufen haben.

ZeileWann sie erscheintSatz beim Schreiben
Modell-Token Bei jeder Inferenz Kurzer Kontext, je 1 Mio. Token, Eingabe / Ausgabe: Luna $0,10 / $0,50, Sol $2 / $10, Astra $10 / $50
Eingebaute Werkzeuge Nur bei einem Aufruf Web Search etwa $10 / 1.000 Aufrufe, gefundener Inhalt zusätzlich als Eingabe-Token
Container environment.type ist openai_hosted 1 / 4 / 16 / 64 GB etwa $0,03 / $0,12 / $0,48 / $1,92 je 20 Minuten und Container. Geeignete Sitzungen minutengenau, mindestens 5 Minuten
Ihr Server Sie brauchen einen Dauerprozess oder macOS Die Agents API enthält diese Zeile nicht. Monatsstarts auf der Startseite: etwa $101,7 (M4 16GB / 256GB) und $200,3 (24GB / 512GB)
Erst die Rechnung, dann den Stückpreis

Das öffentliche Beispiel zum Anlegen einer Sitzung setzt nur openai_hosted. Eine Speicherstufe steht dort nicht. Die Preisseite führt trotzdem vier Containerstufen. Bis eine Rechnung da ist, rechnen Sie 1 GB und 4 GB. Budgetieren Sie nicht nur die billigste Zeile.

Den kleinsten Agent bauen

Der Einstieg ist POST /v1/agents/sessions, der Header OpenAI-Beta: agents=v1. Der Schlüssel braucht api.agents.read, api.agents.write und für Inferenz api.responses.write. Der Schlüssel bleibt im Prozess, der die Anfrage sendet. Schreiben Sie OPENAI_API_KEY nicht in die Sandbox-Umgebung. Reservierte Namen wie PATH und CODEX_* werden abgelehnt.

Kleinste Sitzung: Sol + openai_hosted
curl --no-buffer --fail-with-body https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {
      "model": "gpt-6-sol",
      "instructions": "Write clean code, run it, and report the actual output."
    },
    "environment": { "type": "openai_hosted" },
    "input": "Create tree.py, print a readable tree of the current directory, run it, show the output.",
    "stream": true
  }'

Starten Sie mit gpt-6-sol. Setzen Sie gpt-6-astra nicht auf jede Sitzung. Die Abnahme hat einen Satz: Die Datei wird geschrieben, ausgeführt, und die echte Ausgabe kommt zurück. Nur gemessene schwere Fälle steigen auf Astra. Mit Sub-Agents addieren sich Token je Agent-Kontext. Das ist nicht der Preis einer einzelnen Nutzernachricht.

Datengrenze in der Beta

Die Beta-Doku sagt, die Agents API unterstützt Zero Data Retention nicht. self_hosted schaltet ZDR nicht ein. Dürfen Code oder Schlüssel das Netz nicht verlassen, lesen Sie die Datenkontrollen, bevor Sie eine Sitzung anlegen.

Drei Orte in der Cloud

Deployen heißt hier nicht, noch eine Plattform darumzulegen. Es beantwortet zwei Fragen: Wer ruft die API auf, und auf welcher Maschine laufen die Werkzeuge.

openai_hosted: Skripte und Prüfungen

Die gehostete Sandbox ist ein Linux-Arbeitsbereich mit Python, Node.js und Shell. Das Arbeitsverzeichnis ist /workspace. Sie passt für Skripte, Daten und Repository-Prüfungen ohne Apples Toolchain. Das Netz lässt sich je Aufgabe einschränken. In den Beispielen ist der Zugriff oft zuerst aus, und erst nach einem erfolgreichen Lauf wieder an.

Entwickler an Mehrschirm-Arbeitsplätzen mit Code, für einen Agent auf einer Cloud-Maschine, die wach bleibt
Der Prozess, der die API ruft, muss wach bleiben. Ein zugeklappter Laptop taugt nur dafür, die kleinste Sitzung zu prüfen.

Ein Prozess, der wach bleibt

Ein Prototyp darf diesen curl vom Laptop vor Ihnen senden. Zuklappen beendet eine lange Sitzung. In Produktion liegt der Aufruf in einem Prozess, der nicht schläft: Queue, Webhook oder Timer. Der Prozess darf klein sein. Er kompiliert kein iOS. Eigene Images, GPUs oder ein privates Netz gehören auf self_hosted oder eine Partnerumgebung aus der Doku. Zwingen Sie das nicht in die gehostete Sandbox. Die Felder folgen der Entwicklerdoku.

Wann es ein Mac sein muss

Die gehostete Sandbox ist Linux. xcodebuild, der iOS-Simulator, Signierung und TestFlight brauchen macOS. Die Orchestrierung bleibt auf der Agents API, Apples Toolchain auf einem Cloud Mac. Skripte und Frontend-Prüfungen dürfen in die Sandbox. Archiv und Signierung bleiben auf dem Mac.

Am Schreiberichtag standen auf den Preiskapseln der Startseite: M4 · 16GB / 256GB ab $101,7 im Monat, M4 · 24GB / 512GB ab $200,3 im Monat. Tag, Woche, Monat und Quartal sind wählbar. Eine kurze Abnahme läuft über Tag oder Woche, ein dauerhafter Build danach monatlich. Die Abrechnung folgt der Tarifseite. Ein Startpreis ist hier kein Vertragspreis.

Was die API kostet

Die Tabelle ist kurzer Kontext, US-Dollar je Million Token. Über 272K Eingabe gilt für die ganze Anfrage der lange Kontext: etwa 2× bei Eingabe und Cache, etwa 1,5× bei der Ausgabe. Der Aufschlag gilt nicht nur für den Überhang. Batch / Flex ist etwa die Hälfte des Standards, Fast etwa 2×. Cache-Eingabe ist günstiger. Cache-Schreiben liegt bei etwa 1,25× der nicht gecachten Eingabe.

PostenEingabeCache-EingabeCache-SchreibenAusgabe
gpt-6-luna · kurzer Kontext$0,10$0,01$0,125$0,50
gpt-6-sol · kurzer Kontext$2$0,20$2,50$10
gpt-6-astra · kurzer Kontext$10$1$12,50$50
gpt-6-astra · langer Kontext (>272K)$20$2$25$75
Web SearchEtwa $10 / 1.000 Aufrufe, plus Eingabe-Token für gefundenen Inhalt
Container 1 / 4 / 16 / 64 GB$0,03 / $0,12 / $0,48 / $1,92 je 20 Minuten (5 Minuten Minimum bei Minutenabrechnung)

Liegt eine Route noch auf GPT-5.6 Sol, passte am 20. September ein Aktionspreis von $4 Eingabe und $20 Ausgabe, geschrieben bis zum 21. November. Das ist eine andere Modellzeile. Addieren Sie sie nicht zu den $2 / $10 von gpt-6-sol. Prüfen Sie die Preisseite vor dem Ausrollen noch einmal.

Was der Server dazukommt

  • Sie rufen nur auf, solange Sie am Rechner sitzen. Serverkosten sind $0. Zuklappen stoppt alles. Eine Nachtaufgabe geht nicht.
  • Ein Webhook muss den ganzen Tag laufen, und jedes Werkzeug liegt in der Sandbox oder in einer reinen API. Der Orchestrator ist leicht. Haben Sie schon eine Maschine, die an bleibt, mieten Sie nicht extra einen Mac, nur um die Agents API zu rufen.
  • Sie brauchen macOS. Dann kommt ein Cloud Mac dazu. Der 16GB-Start auf der Startseite liegt bei etwa $101,7 / Monat. Er ersetzt keine Token. Er ersetzt den Schritt, der ohne Mac nicht läuft.
Die Mac-Miete enthält die API nicht

Die beiden Zahlungen kaufen Verschiedenes. Der Mac kann wach sein, und Astra-Ausgabetoken kosten trotzdem $50 je Million. Senken Sie das Standardmodell auf Sol oder Luna, bevor Sie den Mac von täglich auf monatlich umstellen.

Ein Monatsblatt zum Einsetzen

Das ist ein Arbeitsblatt, kein Angebot. Annahme: 22 Arbeitstage, 40 Sitzungen am Tag, zusammen 880. Jede Sitzung ist kurzer Kontext, ohne Cache: 20.000 Eingabe-Token, 4.000 Ausgabe-Token und eine Web Search. Summen: 17,6 Mio. Eingabe und 3,52 Mio. Ausgabe.

PostenLunaSolAstra10 % Astra + 90 % Sol
Modell-Token$3,52$70,40$352$98,56
Web Search (ohne Inhalts-Token)$8,80
Sandbox 5 Min. · 1 GB / 4 GB$6,60 / $26,40
Sandbox 20 Min. · 1 GB / 4 GB$26,40 / $105,60

Drei Vergleiche, noch ohne Token für gefundenen Inhalt:

  • Luna + Suche + 1 GB nur mit 5-Minuten-Minimum: etwa $19 (3,52 + 8,80 + 6,60).
  • Gemischte Modelle + Suche + volle 20 Minuten bei 1 GB: etwa $134 (98,56 + 8,80 + 26,40).
  • Diese Zeile plus 16GB-Cloud-Mac-Start: etwa $235 (134 + 101,7). Ohne Mac bleibt die API-Seite bei etwa $134.

Für Ihr eigenes Volumen ändern Sie drei Zahlen: Sitzungszahl, Eingabe-Token je Sitzung, Ausgabe-Token je Sitzung. Die Stückpreiszeile bleibt an der Preisseite. Werden aus 880 Sitzungen 88, teilen sich Modell, Suche und Container ungefähr durch 10. Die Mac-Miete nicht.

FAQ

Hat die Agents API eine Plattformgebühr?

Die Beta-Ankündigung sagt nein. Sie zahlen Token für das gewählte Modell, eingebaute Werkzeuge, die Sie wirklich aufrufen, und Containerzeit nur bei openai_hosted.

Welches Modell für die tägliche Schleife?

Standard ist gpt-6-sol oder gpt-6-luna. Bei denselben 880 Sitzungen kostet die Modellzeile mit durchgängig Astra $352. Neunzig Prozent Sol und zehn Prozent Astra sind $98,56. Einen schweren Fall heben Sie erst an, wenn ein festes Eval ihn verglichen hat.

Kann die gehostete Sandbox Xcode ausführen?

Nein. Sie ist Linux. Signierung, Simulator und xcodebuild bleiben auf macOS. Ein Cloud Mac deckt diesen Schritt. Er ersetzt die API-Rechnung nicht.

Wo liegt der API-Schlüssel?

Im Prozess, der die API ruft, nicht in der Sandbox-Umgebung. Die Beta unterstützt Zero Data Retention nicht, und self_hosted ist keine Ausnahme.

Wie schätze ich einen Monat?

Nehmen Sie die 880 Sitzungen als Boden und ersetzen Sie Zahl und Token. Rechnen Sie Container mit 1 GB und 4 GB, und sehen Sie sowohl das 5-Minuten-Minimum als auch volle 20 Minuten. Ändert DevDay einen Satz, gilt die Preisseite.

Erst die Sitzung, dann die drei Zeilen

Die Reihenfolge ist: kleinste Sitzung, drei Rechnungszeilen, und erst dann, ob Sie einen Mac brauchen. Das Standardmodell bleibt auf Sol oder Luna. Astra ist für schwere Fälle, die Sie gemessen haben. Linux-Sandbox für Skripte, macOS für Archive. Lassen Sie nicht eine Maschine die andere ersetzen, und ziehen Sie die beiden Rechnungen nicht zu einer einzigen „Agent-Monatsgebühr“ zusammen.

Lange Jobs brauchen eine Maschine, die wach bleibt

Der Laptop ist dafür da, den curl zu prüfen. Nächtliche Agent-Schleifen und xcodebuild gehören auf einen Cloud Mac, der nicht schläft. Der Laptop liest nur Diff und Rechnung.

Tarife ansehen

Notizen · Agents API

Lange Jobs brauchen eine Maschine, die wach bleibt

Agents API · Sandbox · Cloud Mac

Tarife ansehen
Zeitlich begrenzt Tarife ansehen