Diese Seite fasst die vom Gateway zurückgegebenen Statuscodes, ihre Bedeutung und die Maßnahmen für die einzelnen Codes zusammen. Wenn der Upstream einen 4xx- oder 5xx-Code zurückgibt, wird dieser unverändert weitergeleitet. In allen anderen Fällen gilt die folgende Tabelle. Außerdem werden die Formate der Fehlertexte für die beiden kompatiblen Spezifikationen, die Regeln für Anthropic-kompatibles error.type sowie die Konsolenansichten zur Prüfung von Limits und Nutzung beschrieben.
Statuscode
Code
Bedeutung
Maßnahme
400
Fehler in den Anfrageparametern. Das limit der Anthropic-kompatiblen Modellliste liegt außerhalb des Bereichs von 1 bis 1000, oder es wurde versucht, eine gespeicherte Antwort mit GET /responses/{responseId}?stream=true fortzusetzen
Die Werte innerhalb des zulässigen Bereichs korrigieren. Gespeicherte Antworten ohne stream abrufen.
401
Kein Schlüssel vorhanden oder der Schlüssel ist abgelaufen bzw. widerrufen
Den Schlüsselstatus auf der API-Schlüsselseite prüfen und den Header-Namen sowie das Bearer-Präfix überprüfen.
403
Keine Berechtigung für den Modellzugriff, Nutzungslimit überschritten, unzureichendes Guthaben oder nicht der Eigentümer der Voice
error.message unterscheidet die Gründe. Die Zahlen sind in den Ansichten im folgenden Abschnitt zur Prüfung von Limits und Nutzung zu sehen.
404
Modell nicht vorhanden oder mit diesem Schlüssel nicht zugänglich (einschließlich Modelle, deren Unterstützung eingestellt wurde), nicht vorhandener Pfad oder CleviDrive-Ergebnis, dessen Aufbewahrungsfrist von 3 Tagen abgelaufen ist
Zuerst mit GET /models die Liste der aufrufbaren Modelle prüfen. Den Pfad mit der Tabelle auf der Seite „API aufrufen“ abgleichen.
408 · 409 · 413
Upstream-Timeout, Überlastung oder Anfragegröße überschritten. Für Sprach- und Voice-Pfade beträgt das Zeitlimit 5 Minuten, das Anfrage-Limit 28 MiB
Wenn 409 einen Retry-After enthält, die angegebene Zeit warten. Bei 413 die Anfrage aufteilen.
429
Der Upstream-Anbieter hat eine Geschwindigkeitsbegrenzung angewendet
Wenn Retry-After vorhanden ist, diese Vorgabe unverändert befolgen. Andernfalls mit exponentiellem Backoff erneut versuchen.
5xx
Vorübergehender Fehler des Gateways oder Upstreams (einschließlich 503)
Mit exponentiellem Backoff erneut versuchen. Wenn der Fehler wiederholt auftritt, über Hilfe und Kontakt zusammen mit der X-Request-Id informieren.
Wiederholungsversuche
Das Gateway erzeugt keine eigenen 429-Fehler und versucht Upstream-Antworten auch nicht heimlich erneut oder stellt sie in eine Warteschlange. Warten und Wiederholungsversuche werden vom Client durchgeführt.
Code
Wartezeit
Danach
409
Wenn Retry-After vorhanden ist, so lange warten
Dieselbe Anfrage erneut senden.
429
Wenn Retry-After vorhanden ist, so lange warten, andernfalls exponentielles Backoff
Dieselbe Anfrage erneut senden.
5xx
Exponentielles Backoff
Bei Wiederholung den Support kontaktieren.
413
Keine Wartezeit
Die Anfrage aufteilen.
Fehlertext
Der Fehlertext hat je nach Spezifikation ein anderes Format. Upstream-Fehler werden auf die Meldung reduziert und bereinigt weitergeleitet; Stacktraces und interne Felder werden nicht weitergegeben.
Dies ist der Text der OpenAI-kompatiblen Route.
{"error":{"message":"API key is required.","type":"invalid_request_error"}}
Dies ist der Text der Anthropic-kompatiblen Route. error.type wird anhand des Statuscodes festgelegt.
Die Limitwerte unterscheiden sich je nach Workspace. Prüfen Sie den Grund für 403 in error.message und sehen Sie anschließend die Werte auf dem folgenden Bildschirm ein.
Zu prüfen
Konsolenbildschirm
Für meinen Workspace geltendes Limit
Zugewiesenes Nutzungslimit in der Übersicht
Vom Plan erlaubter Umfang und Guthaben
Plan und Credits
Tatsächliche Nutzung (Aufrufe nach Modell und Schlüssel, voraussichtliche abgezogene Credits)
