Fehler

Jeder Chat-Endpunkt gibt Fehler in derselben Struktur wie der API-Standard zurück, mit dem er kompatibel ist (OpenAI, Anthropic oder Gemini). Jede Fehlerantwort enthält außerdem einen X-Request-Id-Header und liefert nur die Informationen, die du zum Debuggen deiner Anfrage benötigst.

OpenAI — `/v1/chat/completions` (sowie Bild-/Video-Endpunkte)

{
  "error": {
    "message": "Insufficient credits",
    "type": "insufficient_quota",
    "code": "insufficient_credits",
    "param": null
  }
}

Anthropic — `/v1/messages`

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key"
  }
}

Gemini — `/v1beta/models/{model}:generateContent`

{
  "error": {
    "code": 400,
    "message": "model is required",
    "status": "INVALID_ARGUMENT"
  }
}

Statuszuordnung

Der Fehler-type / status wird aus dem HTTP-Status abgeleitet:

HTTP	OpenAI `type`	Anthropic `type`	Gemini `status`
400	invalid_request_error	invalid_request_error	INVALID_ARGUMENT
401	authentication_error	authentication_error	UNAUTHENTICATED
403	permission_error	permission_error	PERMISSION_DENIED
404	not_found_error	not_found_error	NOT_FOUND
402	insufficient_quota	invalid_request_error	RESOURCE_EXHAUSTED
429	rate_limit_error	rate_limit_error	RESOURCE_EXHAUSTED
5xx	api_error	api_error / overloaded_error	SERVER_ERROR / UNAVAILABLE

Abgelehnte Modellparameter

Wenn ein Modell einen Wert in Ihrer Anfrage nicht akzeptiert, gibt der Endpunkt HTTP 400 mit der Erklärung des Modells zurück. Für Reasoning-Einstellungen lautet der Code invalid_reasoning_effort, und die Meldung listet die Werte auf, die dieses Modell akzeptiert, sodass die Anfrage ohne Raten korrigiert werden kann. Die akzeptierten Reasoning-Stufen, der Standardwert und ob Reasoning deaktiviert werden kann, stehen in GET /v1/models unter capability_metadata.reasoning. Rate-Limits liefern 429, und eine Anfrage, die das Zeitbudget überschreitet, liefert 504. Ein 502 bedeutet, dass die Plattform nach Wiederholungsversuchen keine verwertbare Antwort des Modells erhalten konnte — es ist kein Urteil über Ihre Parameter; lesen Sie daher den Antworttext, bevor Sie sie ändern.

Fehler bei der Mediengenerierung und Wiederholungen

Entscheide bei der Bild- und Videogenerierung anhand des strukturierten error.code und des Aufgabenfelds status (task.status in deinem Client), welche Meldung angezeigt wird und ob ein erneuter Versuch sinnvoll ist.

Fehlercode	Bedeutung und empfohlene Maßnahme
`not_found`	Bei einer Generierungsaufgabe wurden möglicherweise keine gültigen Medien zurückgegeben, oder der angefragte Endpunkt bzw. die Ressource existiert nicht. Daraus lässt sich kein Verstoß gegen Inhaltsrichtlinien ableiten.
`rate_limit`	Die Anfrage kann begrenzt sein oder der Modelldienst vorübergehend überlastet. Warte und wiederhole den Versuch nur begrenzt, mit zunehmenden Abständen.
`content_policy`, `content_filter`, `image_safety`	Eine ausdrückliche Ablehnung aufgrund von Inhaltsrichtlinien. Bitte den Nutzer, den Inhalt zu ändern.

Empfiehl Inhaltsänderungen nur bei einem eindeutigen Richtliniencode oder einer klaren Ablehnung aufgrund von Inhaltsrichtlinien. Die bloße Erwähnung von safety in einer Meldung oder HTTP 502 allein belegt keinen Verstoß. Solange eine asynchrone Aufgabe pending oder processing ist, frage /v1/tasks/{task_id} mit derselben task_id weiter ab; reiche keine doppelte Generierungsanfrage ein.

Erste Schritte

Integrationen

Core-APIs

Betrieb und Abrechnung

OpenAI — `/v1/chat/completions` (sowie Bild-/Video-Endpunkte)

Anthropic — `/v1/messages`

Gemini — `/v1beta/models/{model}:generateContent`

Statuszuordnung

Abgelehnte Modellparameter

Fehler bei der Mediengenerierung und Wiederholungen

​OpenAI — /v1/chat/completions (sowie Bild-/Video-Endpunkte)

​Anthropic — /v1/messages

​Gemini — /v1beta/models/{model}:generateContent

​Statuszuordnung

​Abgelehnte Modellparameter

​Fehler bei der Mediengenerierung und Wiederholungen

OpenAI — `/v1/chat/completions` (sowie Bild-/Video-Endpunkte)

Anthropic — `/v1/messages`

Gemini — `/v1beta/models/{model}:generateContent`

Statuszuordnung

Abgelehnte Modellparameter

Fehler bei der Mediengenerierung und Wiederholungen