OpenAI-SDK-Kompatibilität

Erste Schritte mit dem OpenAI SDK

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

1. Ein offizielles OpenAI SDK verwenden
2. Folgendes ändern
   • Aktualisiere deine Basis-URL, sodass sie auf die Claude API verweist
   • Ersetze deinen API-Key durch einen Claude API-Key
   • Aktualisiere deinen Modellnamen, um ein Claude-Modell zu verwenden
3. Die nachstehende Dokumentation durchsehen, 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-4-8",  # 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 OpenAI-Kompatibilitätseinschränkungen

API-Verhalten

Hier sind die wesentlichsten Unterschiede zur Verwendung von OpenAI:

• Der strict-Parameter für Function Calling wird ignoriert, was bedeutet, dass nicht garantiert ist, dass das JSON der Tool-Nutzung dem bereitgestellten Schema folgt. Für garantierte Schema-Konformität verwende die native Claude API mit Structured Outputs.
• Audio-Eingaben werden nicht unterstützt; sie werden einfach 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 der Konversation verschoben und zusammengefügt, da Anthropic nur eine einzelne initiale System-Nachricht unterstützt.

Die meisten nicht unterstützten Felder werden stillschweigend ignoriert, anstatt Fehler zu erzeugen. Diese sind alle unten dokumentiert.

Überlegungen zur Ausgabequalität

Wenn du viel an deinem Prompt gefeilt hast, ist er wahrscheinlich speziell auf OpenAI abgestimmt. Erwäge die Verwendung des Prompt-Improvers in der Claude Console als guten Ausgangspunkt.

Verschieben von System-/Developer-Nachrichten

Die meisten Eingaben für das OpenAI SDK lassen sich eindeutig direkt auf die API-Parameter von Anthropic abbilden, aber ein deutlicher Unterschied ist die Behandlung von System-/Developer-Prompts. Diese beiden Prompts können bei OpenAI über eine Chat-Konversation verteilt platziert werden. Da Anthropic nur eine initiale System-Nachricht unterstützt, nimmt die API alle System-/Developer-Nachrichten und fügt sie mit einem einzelnen Zeilenumbruch (\n) dazwischen zusammen. Dieser vollständige String wird dann als einzelne System-Nachricht am Anfang der Nachrichten bereitgestellt.

Unterstützung für erweitertes Denken

Du kannst die Fähigkeiten für erweitertes Denken aktivieren, indem du den thinking-Parameter hinzufügst. Während dies Claudes Reasoning für komplexe Aufgaben verbessert, gibt das OpenAI SDK Claudes detaillierten Denkprozess nicht zurück. Für die vollständigen Funktionen des erweiterten Denkens, einschließlich Zugriff auf Claudes schrittweise Reasoning-Ausgabe, 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 /v1/messages-Endpunkt.

Detaillierte OpenAI-kompatible API-Unterstützung

Request-Felder

Einfache Felder

tools- / functions-Felder

messages-Array-Felder

Response-Felder

Kompatibilität der Fehlermeldungen

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

Header-Kompatibilität

Während 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 damit arbeiten müssen.