Fehlercodes

Verstehen von API-Fehlerantworten

Fehlerantwort-Format
Alle Fehlermeldungen folgen diesem Format:
{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}
Fehlercodes
400Bad Request

Die Anfrageparameter sind ungültig oder fehlerhaft.

Lösung: Überprüfen Sie Ihren Anfrage-Body und stellen Sie sicher, dass alle erforderlichen Felder vorhanden sind und gültige Werte enthalten.

401Unauthorized

Ungültiger oder fehlender API-Schlüssel.

Lösung: Stellen Sie sicher, dass Sie einen gültigen API-Schlüssel im Authorization-Header angeben.

402Payment Required

Nicht genügend Guthaben in Ihrem API-Wallet.

Lösung: Kaufe mehr Credits oder warte, bis deine Credits wieder aufgefüllt werden.

403Forbidden

API-Zugriff nicht genehmigt oder Ihr Konto wurde gesperrt.

Lösung: Wenden Sie sich an den Support, wenn Sie glauben, dass dies ein Fehler ist.

404Not Found

Die angeforderte Ressource (Aufgabe, Webhook usw.) wurde nicht gefunden.

Lösung: Überprüfen Sie, ob die Ressourcen-ID korrekt ist.

429Too Many Requests

Zu viele Anfragen in kurzer Zeit.

Lösung: Implementieren Sie exponentielles Backoff und respektieren Sie Ratenlimits.

500Internal Server Error

Bei uns ist etwas schiefgelaufen.

Lösung: Wiederholen Sie die Anfrage nach einer kurzen Pause. Falls das Problem weiterhin besteht, wenden Sie sich an den Support.

Rate Limits
Standard-Ratenbegrenzungen:
MetrikLimit
Anfragen pro Minute60
Anfragen pro Tag10,000
Gleichzeitige Aufgaben5
Nano Banana Pro API