Fehler

Fehlgeschlagene Anfragen geben JSON mit einem error-Objekt zurück. Der HTTP-Status ist das erste Signal; Die Felder message und code benennen den tatsächlichen Fehler.

JSON

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Allgemeine Statuscodes

Status	Typische Ursache
400	Ungültiges JSON, nicht unterstütztes Feld oder falscher Endpunkt für das Modell
401	Fehlender oder ungültiger API-Schlüssel
403	Der Schlüssel kann dieses Modell oder diese Gruppe nicht verwenden
404	Unbekannter Pfad oder fehlende Aufgabe
429	Ratenbegrenzung
499	Der Client hat die Anfrage abgebrochen
5xx	Dienstanbieter- oder Gateway-Fehler

An das falsche Protokoll gesendete Bild- und Videoanfragen geben 400 mit unsupported_endpoint zurück und benennen die erforderliche API. Die stille Protokollkonvertierung gilt nur für Textmodelle.

Längere Diagnosen, Wiederholungsversuche und Fallbacks gehören zu den technischen Artikeln auf der Hauptseite, beginnend mit AI API-Fehlerbehebung.