Das OpenAI Agents SDK mit eigener Basis-URL

Übergeben Sie dem SDK diesen Client, stellen Sie es auf Chat Completions um und schalten Sie das Tracing aus, dann laufen Ihre Agenten mit Ihrem AIGROW-Schlüssel auf Claude-, GPT- und Grok-Modellen.

Sie haben schon einen Code? Lösen Sie ihn unter API-Zugang ein und erstellen Sie dann einen Schlüssel.

Python, bevor Sie einen Agenten erstellen

from openai import AsyncOpenAI
from agents import (
    Agent,
    Runner,
    set_default_openai_api,
    set_default_openai_client,
    set_tracing_disabled,
)

client = AsyncOpenAI(base_url="https://aigrow.gg/v1", api_key="ag_your_key_here")
set_default_openai_client(client, use_for_tracing=False)
set_default_openai_api("chat_completions")
set_tracing_disabled(True)

agent = Agent(name="Assistant", model="claude-opus-5.5")
result = Runner.run_sync(agent, "Reply with the word ready")
print(result.final_output)

Ersetzen Sie ag_your_key_here durch einen Schlüssel aus dem API-Zugang.

Wo die Einstellung liegt

Python-Paket
pip install openai-agents

Oder jeweils ein Agent einzeln

OpenAIChatCompletionsModel stellt einen einzelnen Agenten über seinen eigenen Client auf Chat Completions um und lässt die Standardeinstellungen des SDK unverändert.

from openai import AsyncOpenAI
from agents import Agent, OpenAIChatCompletionsModel, set_tracing_disabled

set_tracing_disabled(True)
client = AsyncOpenAI(base_url="https://aigrow.gg/v1", api_key="ag_your_key_here")

agent = Agent(
    name="Assistant",
    model=OpenAIChatCompletionsModel(model="gpt-6-astra", openai_client=client),
)

Oder mit Umgebungsvariablen

Der OpenAI-Client liest diese beiden selbst, und die letzte schaltet das Tracing aus. Ihr Code ruft weiterhin vor dem ersten Lauf set_default_openai_api("chat_completions") auf.

export OPENAI_BASE_URL=https://aigrow.gg/v1
export OPENAI_API_KEY=ag_your_key_here
export OPENAI_AGENTS_DISABLE_TRACING=1

Welches Modell Sie verwenden

Tragen Sie die ID genau so ein, wie sie hier steht.

Claude Opus 5.5claude-opus-5.5
Die Voreinstellung in jedem Block auf dieser Seite und das günstigste Claude-Modell hier pro gesendetem und empfangenem Token. Kontext: 1.000.000 Tokens.
Grok 4.7grok-4.7
Der niedrigste Ausgabepreis hier. Sein Kontext ist nur halb so groß wie bei den Claude-Modellen. Kontext: 500.000 Tokens.
GPT-6 Astragpt-6-astra
Für ein GPT-Modell. Es kostet pro Token genauso viel wie Fable, mehr als Opus. Kontext: 1.050.000 Tokens.
Claude Fable 5.1claude-fable-5.1
Kostet pro Token mehr als Opus. Vergleichen Sie beide im Coding-Leaderboard, bevor Sie wechseln. Kontext: 1.000.000 Tokens.

Die Preisliste enthält jede ID mit ihrem Guthabensatz, Claude API pricing nennt die Listenpreise, und das Coding-Leaderboard vergleicht die Modelle bei Coding-Aufgaben.

Prüfen, ob es funktioniert

Zuerst der Schlüssel für sich, dann OpenAI Agents SDK damit.

Der Schlüssel

Fragen Sie die Modellliste ab. Dafür brauchen Sie einen gültigen Schlüssel, es entstehen keine Kosten.

curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"

Bei einem funktionierenden Schlüssel kommt die Liste zurück:

{
  "object": "list",
  "data": [
    { "id": "claude-opus-5.5", "object": "model", ... },
    { "id": "claude-fable-5.1", "object": "model", ... },
    { "id": "gpt-6-astra", "object": "model", ... },
    { "id": "claude-sonnet-5.5", "object": "model", ... },
    { "id": "gpt-6.1-sol", "object": "model", ... },
    { "id": "grok-4.7", "object": "model", ... },
    ...
  ],
  "has_more": false
}

OpenAI Agents SDK

Speichern Sie den Block als check.py, tragen Sie Ihren Schlüssel ein und führen Sie ihn aus.

python check.py

Bei einer funktionierenden Einrichtung wird die Antwort des Agenten ausgegeben:

ready

Wenn es fehlschlägt

Zuerst die Fehler von OpenAI Agents SDK, dann die Antworten, die der Endpunkt für jedes Tool gibt.

404 bei jedem Lauf
Das SDK nutzt noch die Responses API, seine Standardeinstellung. Rufen Sie vor dem ersten Lauf set_default_openai_api("chat_completions") auf oder geben Sie dem Agenten ein OpenAIChatCompletionsModel.
Tracing-Client-Fehler 401
Das Tracing lädt jeden Lauf mit demselben Schlüssel wie die Modellaufrufe zu OpenAI hoch, und ein AIGROW-Schlüssel ist kein OpenAI-Schlüssel. set_tracing_disabled(True) stoppt das; set_tracing_export_api_key mit einem Schlüssel von platform.openai.com behält es bei.
Mein Tool meldet 401 oder einen Authentifizierungsfehler
Der Schlüssel fehlt oder ist falsch eingegeben. Kopieren Sie ihn erneut unter API-Zugang im Dashboard und achten Sie darauf, dass er als Schlüssel gesendet wird, nicht als Modellname. Ein widerrufener Schlüssel führt zum gleichen Fehler: Erstellen Sie einen neuen und tauschen Sie ihn aus.
Ich erhalte 402 oder eine Meldung zum Guthaben
Ihr Guthaben ist aufgebraucht. Öffnen Sie im Dashboard den API-Zugang, lösen Sie einen Code ein oder kaufen Sie ein weiteres Paket, dann geht die nächste Anfrage durch. Weitere Änderungen sind nicht nötig.
Es erscheint 404 oder Unknown model
Das Modell muss eines sein, das der Endpunkt bereitstellt, zum Beispiel claude-opus-5.5. Die Schreibweisen des Anbieters funktionieren ebenfalls (claude-opus-5-5, anthropic/claude-opus-5.5), aber eine ID mit Datum oder ein Modell außerhalb des Katalogs wird abgelehnt, bevor die Anfrage weitergeleitet wird, und es wird nichts berechnet. Rufen Sie GET /v1/models mit Ihrem Schlüssel auf, um die aktuelle Liste zu erhalten, oder lesen Sie die IDs in der Preisliste nach.
Anfragen werden mit 429 abgelehnt
Die Kapazität des Endpunkts teilen sich alle Kunden: etwa 20 Anfragen pro Minute und 4 gleichzeitig. Jede 429-Antwort enthält einen retry-after-Header, und die SDKs von OpenAI und Anthropic warten so lange und versuchen es automatisch erneut. Warten Sie in einer eigenen Schleife die angegebenen Sekunden oder verringern Sie die Parallelität.
Das Modell ist gerade nicht verfügbar
Ein 404 mit dem Hinweis, dass das Modell gerade nicht verfügbar ist, bedeutet, dass es beim Upstream-Anbieter kurzzeitig ausgefallen ist. Das liegt nicht an Ihrem Schlüssel oder Ihrem Guthaben. Versuchen Sie es gleich noch einmal oder senden Sie die Anfrage an ein anderes Modell.
Ich erhalte einen 502 oder 503
Ein vorübergehender Aussetzer beim Upstream-Anbieter oder in der Konfiguration. Ihr Guthaben wird dafür nicht belastet. Wiederholen Sie die Anfrage. Falls sie weiterhin scheitert, melden Sie sich über den Store bei uns, dann gehen wir der Sache nach.

Was über AIGROW nicht funktioniert

  • Die gehosteten Tools wie WebSearchTool und FileSearchTool, die OpenAI nur mit der Responses API anbietet. Funktions-Tools, die Sie selbst schreiben, laufen in Ihrem eigenen Code und funktionieren.

  • Traces im OpenAI-Dashboard ohne OpenAI-Schlüssel. Für den Upload ist ein Schlüssel von platform.openai.com nötig, den Sie mit set_tracing_export_api_key setzen.

  • Felder, die nur die Responses API kennt, etwa previous_response_id und conversation_id. Bei Chat Completions verwirft das SDK sie ohne Fehlermeldung.

  • Live-Websuche im Modell. Ein Websuche-Tool, das mit einer Anfrage gesendet wird, wird aus dem bereits vorhandenen Wissen des Modells beantwortet, ohne Live-Ergebnisse. Ein Tool, das Seiten auf Ihrem eigenen Rechner abruft, funktioniert weiterhin.

  • Jeder Endpunkt außer diesen dreien: /v1/messages, /v1/chat/completions und /v1/models. Die Responses API, Embeddings und das Zählen von Tokens antworten mit 404.

  • Router-Felder wie models, route, provider und plugins. Sie werden verworfen, sodass eine Anfrage immer an das eine Modell geht, das sie nennt.

Was ein Monat mit OpenAI Agents SDK kostet

OpenAI Agents SDK wird pro Token zu den Guthabensätzen in der Preisliste abgerechnet. Ein Agent sendet bei jedem Schritt die gesamte Unterhaltung erneut, daher kostet eine lange Aufgabe mehr, als die letzte Nachricht vermuten lässt. Das Aktivitätsprotokoll im API-Zugang zeigt, was jede Anfrage gekostet hat.

Fragen zu OpenAI Agents SDK und einer eigenen API

Kann das OpenAI Agents SDK einen anderen Anbieter nutzen?
Ja, jeden Endpunkt, der das OpenAI-Protokoll spricht. Übergeben Sie an set_default_openai_client einen AsyncOpenAI-Client mit base_url https://aigrow.gg/v1 und Ihrem Schlüssel und rufen Sie set_default_openai_api("chat_completions") auf.
Warum liefert das Agents SDK mit einer eigenen Base-URL einen 404-Fehler?
Es ruft standardmäßig die Responses API auf, der Endpunkt unterstützt aber nur Chat Completions. Mit set_default_openai_api("chat_completions") oder OpenAIChatCompletionsModel stellen Sie das um.
Was macht das Tracing ohne OpenAI-Schlüssel?
Tracing ist standardmäßig aktiv und lädt jeden Lauf mit demselben Schlüssel wie die Modellaufrufe zu OpenAI hoch. Mit einem AIGROW-Schlüssel schlägt der Upload daher mit einem 401-Tracing-Fehler fehl. Schalten Sie es mit set_tracing_disabled(True) oder OPENAI_AGENTS_DISABLE_TRACING=1 ab oder hinterlegen Sie mit set_tracing_export_api_key einen OpenAI-Schlüssel.
Kann ein Agent mit einem Claude-Modell laufen?
Ja. Der Endpunkt stellt Claude-Modelle über das OpenAI-Protokoll bereit, daher funktioniert model="claude-opus-5.5" mit dem Client aus dem Block, ganz ohne Adapter.

Quellen: OpenAI Agents SDK Models · OpenAI Agents SDK Configuration · OpenAI Agents SDK Tracing · OpenAI Agents SDK Tools. Abgerufen am 21. Oktober 2026.

Ein anderes Tool einrichten

  • Claude CodeAnthropic-Protokoll

    Vier Umgebungsvariablen, in der Shell oder in der settings.json.

  • ClineOpenAI-Protokoll

    Der Anbieter OpenAI Compatible, vier Felder im Einstellungsbildschirm.

  • Roo CodeOpenAI-Protokoll

    Der Provider OpenAI Compatible, mit denselben Feldern wie bei Cline.

  • Kilo CodeOpenAI-Protokoll

    Ein eigener Provider im Tab Providers; die Modellliste füllt sich von selbst.

  • ContinueOpenAI-Protokoll

    Ein models-Eintrag in config.yaml mit provider openai und einer apiBase.

  • AiderOpenAI-Protokoll

    OPENAI_API_BASE und OPENAI_API_KEY, dann openai/ vor der Modell-ID.

  • OpenCodeOpenAI-Protokoll

    Ein Provider-Block in opencode.json und der Schlüssel über /connect.

  • ZedAnthropic- und OpenAI-Protokoll

    Ein Anthropic-kompatibler Provider für Claude, ein OpenAI-kompatibler für GPT und Grok.

  • GooseOpenAI-Protokoll

    Der OpenAI-Provider mit OPENAI_HOST oder eine eigene Provider-Datei.

  • Vercel AI SDKAnthropic- und OpenAI-Protokoll

    Der OpenAI-Compatible-Anbieter für jedes Modell oder der Anthropic-Anbieter für Claude.

  • LangChainAnthropic- und OpenAI-Protokoll

    ChatOpenAI mit base_url für jedes Modell oder ChatAnthropic für Claude.

Der API-Leitfaden behandelt die SDKs, curl, die Endpunkte und die Ratenlimits.

Fügen Sie den Block ein, und OpenAI Agents SDK läuft mit Ihrem Guthaben.

Kaufen Sie ein Guthabenpaket, lösen Sie den Code aus Ihrer E-Mail im API-Zugang ein, erstellen Sie einen Schlüssel und setzen Sie ihn anstelle von ag_your_key_here ein.