OpenAI-SDK-Kompatibilität

Erste Schritte mit dem OpenAI SDK

Um die OpenAI SDK-Kompatibilitätsfunktion zu verwenden, musst du:

1. Ein offizielles OpenAI SDK verwenden.
2. Folgendes ändern:
   • Aktualisiere deine Basis-URL so, dass sie auf die Claude API verweist.
   • Ersetze deinen API-Key durch einen Claude API-Key aus der Claude Console.
   • Wenn dein Key ein persönlicher oder Service-Account-Key ist, der nicht auf einen Workspace beschränkt ist, sende bei jeder Anfrage zusätzlich den Header anthropic-workspace-id (zum Beispiel default_headers im Python SDK oder defaultHeaders in TypeScript); siehe Einen Workspace auswählen.
   • Aktualisiere deinen Modellnamen, sodass ein Claude-Modell verwendet wird.
3. Lies die folgenden Abschnitte, um zu erfahren, welche Funktionen unterstützt werden.

Schnellstart-Beispiel

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),  # Your Claude API key
    base_url="https://api.anthropic.com/v1/",  # the Claude API endpoint
)

response = client.chat.completions.create(
    model="claude-opus-5-5",  # Claude model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
)

print(response.choices[0].message.content)

Wichtige Einschränkungen der OpenAI-Kompatibilität

API-Verhalten

Hier sind die wesentlichsten Unterschiede zur Verwendung von OpenAI:

• Der Parameter strict für Function Calling wird ignoriert, was bedeutet, dass nicht garantiert ist, dass das JSON der Tool-Nutzung dem angegebenen Schema entspricht. Für garantierte Schemakonformität verwende die native Claude API mit Structured Outputs.
• Audio-Eingaben werden nicht unterstützt; sie werden ignoriert und aus der Eingabe entfernt.
• Prompt-Caching wird nicht unterstützt, ist aber in den Anthropic SDKs verfügbar.
• System-/Developer-Nachrichten werden an den Anfang verschoben und im Top-Level-Feld system zusammengefügt, unabhängig davon, wo sie in der Konversation erscheinen. Um Systemanweisungen mitten in einer Konversation hinzuzufügen, verwende System-Nachrichten mitten in der Konversation in der nativen Claude API.

Die meisten nicht unterstützten Felder werden stillschweigend ignoriert, anstatt Fehler zu erzeugen. Sie sind alle in den folgenden Abschnitten dokumentiert.

Überlegungen zur Ausgabequalität

Wenn du deinen Prompt umfassend angepasst hast, ist er wahrscheinlich speziell auf OpenAI abgestimmt. Erwäge, ihn für Claude mithilfe des Leitfadens Best Practices für Prompts zu überarbeiten.

Verschieben von System-/Developer-Nachrichten an den Anfang

Die meisten Eingaben des OpenAI SDK lassen sich eindeutig direkt auf Parameter der Claude API abbilden, ein deutlicher Unterschied ist jedoch die Behandlung von System-/Developer-Prompts. Diese beiden Prompts können in der OpenAI API an beliebiger Stelle einer Chat-Konversation platziert werden. Die Kompatibilitätsschicht nimmt alle System-/Developer-Nachrichten und fügt sie mit einem einzelnen Zeilenumbruch (\n) dazwischen zusammen. Dieser vollständige String wird dann als Top-Level-Feld system vor allen Nachrichten übergeben.

Unterstützung für Nachdenken

Du kannst Nachdenken aktivieren, indem du den Parameter thinking hinzufügst. Bei aktuellen Modellen ist das Nachdenken adaptiv, wobei Claude bestimmt, wann und wie tief nachgedacht wird, und bei Claude-5-Modellen ist es standardmäßig aktiviert; manuell konfiguriertes erweitertes Nachdenken ist ein veralteter Modus. Obwohl Nachdenken Claudes Schlussfolgerungen bei komplexen Aufgaben verbessert, gibt das OpenAI SDK Claudes Nachdenken nicht zurück. Für den vollen Funktionsumfang des Nachdenkens, einschließlich des zusammengefassten Nachdenkens, verwende die native Claude API.

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Who are you?"}],
    extra_body={"thinking": {"type": "enabled", "budget_tokens": 2000}},
)

Ratenlimits

Ratenlimits folgen den Standardlimits von Anthropic für den Endpunkt /v1/messages.

Detaillierte Unterstützung der OpenAI-kompatiblen API

Anfragefelder

Einfache Felder

tools- / functions-Felder

Felder des messages-Arrays

Antwortfelder

Kompatibilität von Fehlermeldungen

Die Kompatibilitätsschicht behält konsistente Fehlerformate mit der OpenAI API bei. Die detaillierten Fehlermeldungen sind jedoch nicht gleichwertig. Verwende die Fehlermeldungen nur für Logging und Debugging.

Header-Kompatibilität

Obwohl das OpenAI SDK Header automatisch verwaltet, findest du hier die vollständige Liste der von der Claude API unterstützten Header für Entwickler, die direkt mit ihnen arbeiten müssen.