Admesh/DokumenteErste Schritte

Fehlercodes

Updated 19.9.2026

Fehlgeschlagene Anfragen geben eine einheitliche Fehlerstruktur zurück; das Feld code ist ein maschinenlesbarer Code.

Fehlercodetabelle

HTTP Code Abrechnung Beschreibung
400 invalid_request Nein Ungültige Anfrageparameter
401 invalid_api_key Nein Fehlender oder ungültiger API-Schlüssel
402 insufficient_balance Nein Guthaben unzureichend – aufladen
403 model_not_allowed Nein Modell für diesen Schlüssel nicht autorisiert
429 rate_limit_exceeded Nein Ratenbegrenzung – später erneut versuchen
500 billing_settlement_error Asynchrone Abstimmung Fehler bei der Abrechnung
502 upstream_error Normalerweise nein Fehler beim vorgelagerten Dienst
503 model_provider_unavailable Nein Modelldienst vorübergehend nicht verfügbar
504 upstream_timeout Normalerweise nein Zeitüberschreitung im vorgelagerten Dienst

Fehlerbehebung

  1. 401: Vergewissern Sie sich, dass der Authorization: Bearer-Wert dem vollständigen sk-live-*-Geheimnis entspricht und der Schlüssel nicht widerrufen wurde.
  2. 402: In der Konsole aufladen.
  3. 429: Die Parallelität verringern oder vor einem erneuten Versuch auf retry-after warten.
  4. 5xx: Versuchen Sie es später erneut; sollte das Problem weiterhin bestehen, wenden Sie sich mit dem request_id an den Support.

Fehlerbeispiel

{
  "error": {
    "message": "insufficient balance",
    "type": "request_error",
    "code": "insufficient_balance",
    "param": null,
    "request_id": "req_8f2a…c91d"
  }
}