Referenz

Fehler

Fehler kommen im OpenAI-Format zurück, mit einem stabilen code, nach dem Sie suchen können, und einer message, die für Menschen geschrieben ist. Ein abgelehnter oder fehlgeschlagener Aufruf kostet nichts.

Geprüft am 26. Oktober 2026

Der Aufbau

Response

{
  "error": {
    "type": "rate_limit_error",
    "code": "daily_cap",
    "message": "This call needs up to $0.02 and the key has $0.01 left of its $2.00 daily cap, which resets at 00:00 UTC. …"
  }
}

Richten Sie sich nach code, nicht nach message: Meldungen können umformuliert werden, Codes bleiben. type folgt dem von OpenAI, sodass SDKs die Ausnahme auslösen, die Sie erwarten.

Jeder Code

Status	Code	Wann	Lösung
401	`missing_key`	Es wurde kein Schlüssel gesendet.	Senden Sie ihn als `Authorization: Bearer sk-nokeep-…`. Erstellen Sie einen in der Konsole, oder testen Sie zuerst `sk-nokeep-test`.
401	`invalid_key`	Der Schlüssel ist falsch oder wurde widerrufen.	Kopieren Sie den Schlüssel erneut von dort, wo Sie ihn gespeichert haben; die Konsole zeigt nur die letzten vier Zeichen. Ist er verloren, erstellen Sie einen neuen.
403	`account_frozen`	Bezahlfunktionen sind für das Konto des Schlüssels pausiert.	Schreiben Sie uns über die Kontaktseite.
429	`rate_limited`	Der Schlüssel hat mehr als 120 Anfragen in einer Minute gesendet (20 beim Testschlüssel, pro Adresse).	Warten Sie die Sekunden aus `Retry-After` ab und versuchen Sie es erneut.
429	`daily_cap`	Der Aufruf könnte das Tageslimit des Schlüssels überschreiten.	Erhöhen Sie das Limit in der Konsole, senken Sie `max_tokens` oder warten Sie bis 00:00 UTC (`Retry-After` sagt, wie lange).
402	`insufficient_credits`	Das gekaufte Guthaben des Kontos reicht für diesen Aufruf nicht.	Laden Sie in der Konsole ab $5 auf, oder senken Sie `max_tokens`. Das Guthaben eines Tarifs bleibt in der App.
400	`invalid_json`	Der Body ist kein JSON-Objekt.	Senden Sie `Content-Type: application/json` und ein JSON-Objekt.
413	`too_large`	Die Anfrage ist größer als 12 MB.	Senden Sie Bilder als Links statt als Data-URLs, oder senden Sie weniger auf einmal.
404	`model_not_found`	Die Modell-ID gehört nicht zu unseren.	`GET /v1/models` listet die IDs. Prüfen Sie auf Tippfehler oder ein fehlendes `-uncensored`.
400	`invalid_messages`	`messages` fehlt oder ist leer, zu lang, hat eine unbekannte Rolle, oder einer Tool-Nachricht fehlt `tool_call_id`.	Senden Sie 1 bis 2.000 Nachrichten, jede mit der Rolle system, developer, user, assistant oder tool.
400	`unsupported_n`	`n` ist größer als 1.	Senden Sie eine Anfrage pro gewünschter Antwort.
400	`invalid_reasoning_effort`	Das Modell akzeptiert diesen `reasoning_effort` nicht.	DeepSeek akzeptiert none, low, high oder max. GLM akzeptiert low oder high.
400	`unsupported_tool_choice`	GLM hat eine benannte Funktion oder "required" als `tool_choice` bekommen.	Senden Sie GLM auto oder none; es wählt seine Tools selbst. DeepSeek akzeptiert jede Form.
400	`unsupported_input`	Ein Inhaltsteil hat eine Art, die das Modell nicht lesen kann.	Senden Sie Bilder an DeepSeek; GLM liest nur Text.
400	`too_many_images`	Mehr als zehn Bilder in einer Anfrage.	Senden Sie höchstens zehn.
422	`hard_limit`	Die Anfrage überschreitet eine der festen Grenzen in den Bedingungen.	Es wurde nichts berechnet. Entfernen Sie die Nachricht aus dem Verlauf, den Sie zurücksenden, sonst stoppt auch der nächste Aufruf.
400	`rejected`	Das Modell konnte die Anfrage so nicht annehmen.	Gleichen Sie die Parameter mit der Liste des Modells unter Modelle ab. Es wurde nichts berechnet.
503	`busy`	Das Modell ist ausgelastet.	Versuchen Sie es nach den Sekunden aus `Retry-After` erneut. Es wurde nichts berechnet.
503	`model_unavailable`	Das Modell ist bei uns offline.	Nutzen Sie vorerst das andere Modell; die Statusseite zeigt, wann es zurück ist.
502	`upstream_error`	Das Modell ist gescheitert, bevor es ein Wort geschrieben hat.	Versuchen Sie es gleich noch einmal. Es wurde nichts berechnet.
404	`not_found`	Die Route existiert nicht.	Die API bedient `GET /v1/models`, `GET /v1/models/{id}`, `GET /v1/status` und `POST /v1/chat/completions`.
404	`api_closed`	Die API ist abgeschaltet.	Versuchen Sie es später erneut.

Im Stream	Code	Wann	Lösung
—	`stream_cut`	Das Modell hat mitten im Stream aufgehört, bevor es fertig war.	Berechnet wird nur, was es geschrieben hat. Versuchen Sie es erneut für den Rest, oder machen Sie mit dem Angekommenen weiter.

Welche Sie wiederholen sollten

Wiederholen Sie 429 rate_limited, 503 busy und 502 upstream_error, nach den Sekunden aus Retry-After, wenn vorhanden.
Wiederholen Sie die 400er, 401er, 402, 404er oder 422 nicht: Dieselbe Anfrage bekommt dieselbe Antwort.
Ein 429 daily_cap endet erst um 00:00 UTC. Erhöhen Sie stattdessen das Limit.

API-Schlüssel holen Kostenlosen Testschlüssel ausprobieren: sk-nokeep-test

Der Aufbau

Jeder Code

Welche Sie wiederholen sollten

Was beschäftigt Sie?