OpenAI SDK-Kompatibilität (Beta)

​

Bevor Sie beginnen

Diese Kompatibilitätsschicht ist für das Testen und Vergleichen von Modellfähigkeiten mit minimalem Entwicklungsaufwand gedacht und wird für die meisten Anwendungsfälle nicht als langfristige oder produktionsreife Lösung betrachtet. Für die beste Erfahrung und Zugriff auf den vollen Funktionsumfang der Anthropic API (PDF-Verarbeitung, Zitationen, erweitertes Denken und Prompt-Caching) empfehlen wir die Verwendung der nativen Anthropic API.

​

Erste Schritte mit dem OpenAI SDK

Um die OpenAI SDK-Kompatibilitätsfunktion zu nutzen, müssen Sie:

1. Ein offizielles OpenAI SDK verwenden
2. Folgendes ändern
   • Aktualisieren Sie Ihre Basis-URL zur Anthropic API
   • Ersetzen Sie Ihren API-Schlüssel durch einen Anthropic API-Schlüssel
   • Aktualisieren Sie Ihren Modellnamen zur Verwendung eines Claude-Modells
3. Überprüfen Sie die nachfolgende Dokumentation für unterstützte Funktionen

​

Schnellstart-Beispiel

​

Wichtige OpenAI-Kompatibilitätseinschränkungen

​

API-Verhalten

Hier sind die wesentlichsten Unterschiede zur Verwendung von OpenAI:

• Der strict-Parameter für Funktionsaufrufe wird ignoriert, was bedeutet, dass das Tool-Use-JSON nicht garantiert dem bereitgestellten Schema folgt
• Audio-Eingabe wird nicht unterstützt; sie wird einfach ignoriert und aus der Eingabe entfernt
• Prompt-Caching wird nicht unterstützt, ist aber im Anthropic SDK verfügbar
• System-/Entwicklernachrichten werden an den Anfang der Konversation verschoben und zusammengefügt, da Anthropic nur eine einzige initiale Systemnachricht 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 Sie Ihren Prompt stark optimiert haben, ist er wahrscheinlich speziell auf OpenAI abgestimmt. Erwägen Sie die Verwendung unseres Prompt-Verbesserers in der Anthropic Console als guten Ausgangspunkt.

​

System- / Entwicklernachrichten-Verschiebung

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

​

Unterstützung für erweitertes Denken

Sie können erweitertes Denken durch Hinzufügen des thinking-Parameters aktivieren. Während dies Claudes Denkvermögen für komplexe Aufgaben verbessert, wird das OpenAI SDK Claudes detaillierten Denkprozess nicht zurückgeben. Für vollständige erweiterte Denkfunktionen, einschließlich Zugriff auf Claudes schrittweise Denkausgabe, verwenden Sie die native Anthropic API.

​

Ratenlimits

Ratenlimits folgen Anthropics Standardlimits für den /v1/messages-Endpunkt.

​

Detaillierte OpenAI-kompatible API-Unterstützung

​

Anfragefelder

​

Einfache Felder

​

tools / functions Felder

​

messages Array-Felder

​

Antwortfelder

​

Fehlermeldungs-Kompatibilität

Die Kompatibilitätsschicht behält konsistente Fehlerformate mit der OpenAI API bei. Die detaillierten Fehlermeldungen werden jedoch nicht äquivalent sein. Wir empfehlen, die Fehlermeldungen nur für Protokollierung und Debugging zu verwenden.

​

Header-Kompatibilität

Während das OpenAI SDK die Header automatisch verwaltet, hier die vollständige Liste der von Anthropics API unterstützten Header für Entwickler, die direkt damit arbeiten müssen.