Fehler
Jeder HTTP-Status und Fehlercode, den die Cheapest Imagen API zurückgibt, was er bedeutet, ob berechnet wurde und was Sie als Nächstes tun sollten.
Fehler haben dieselbe Form wie bei OpenAI:
{
"error": {
"message": "Not enough credits for this request.",
"type": "invalid_request_error",
"param": null,
"code": "insufficient_credits"
}
}Jede Antwort trägt einen Header x-request-id. Geben Sie ihn an, wenn Sie den Support kontaktieren.
| Status | code | Bedeutung | Was zu tun ist |
|---|---|---|---|
| 400 | missing_required_parameter | Ein Pflichtfeld fehlt | Fügen Sie das in param genannte Feld hinzu |
| 400 | invalid_value | Ein Feld hat einen nicht akzeptierten Wert | Korrigieren Sie das in param genannte Feld |
| 400 | unsupported_parameter | Das Feld ist nicht verfügbar oder nicht bei diesem Modell (zum Beispiel svg bei einem Modell ohne SVG-Ausgabe) | Entfernen Sie das Feld oder wählen Sie ein Modell, das es hat |
| 400 | model_not_found | Das Modell existiert nicht oder ist nicht freigegeben | Nutzen Sie ein Modell aus GET /v1/models |
| 400 | moderation_blocked | Der Prompt oder das Bild wurde von der Inhaltsprüfung abgelehnt | Ändern Sie den Prompt. Nicht berechnet, außer auf den Stable-Kanälen von Nano Banana (-1k, -2k, -4k) |
| 401 | invalid_api_key | Der Schlüssel fehlt oder ist falsch | Prüfen Sie den Header Authorization |
| 402 | insufficient_credits | Nicht genug Credits | Aufladen |
| 403 | account_suspended | Das Konto oder der Schlüssel ist deaktiviert | Kontaktieren Sie den Support |
| 409 | idempotency_key_in_use | Der Idempotency-Key wurde bereits verwendet | Warten Sie auf die erste Anfrage oder nutzen Sie einen neuen Schlüssel |
| 413 | request_too_large | Die Anfrage oder ein Bild ist zu groß | Senden Sie kleinere oder weniger Bilder |
| 429 | rate_limit_exceeded | Mehr als 300 Anfragen in einer Minute | Langsamer senden und erneut versuchen |
| 429 | concurrency_limit_exceeded | Mehr als 50 Anfragen gleichzeitig | Warten, bis eine fertig ist |
| 429 | moderation_paused | Mehr als 10 abgelehnte Anfragen in einer Stunde | Eine Stunde warten |
| 502 | upstream_error | Das Bild konnte nicht erstellt werden | Erneut versuchen. Nicht berechnet |
| 504 | upstream_timeout | Die Erstellung dauerte länger als 420 Sekunden | Erneut versuchen. Nicht berechnet |
Wann Sie belastet werden
Nur für Bilder, die Sie erhalten. Fehlgeschlagene Anfragen, solche mit Zeitüberschreitung und abgelehnte kosten nichts. Die Ausnahme: Die Stable-Kanäle von Nano Banana (-1k, -2k, -4k) berechnen wegen ihres Inhalts abgelehnte Bilder, weil der Anbieter sie berechnet.
Rate Limits und Massenerstellung
Die Limits der Cheapest Imagen API (300 pro Minute, 50 gleichzeitig), was ein 429 bedeutet und wie Sie Tausende Bilder mit Wiederholungen ohne Doppelabrechnung erstellen.
Von OpenAI wechseln
Bringen Sie Code für die OpenAI Images API zu Cheapest Imagen, indem Sie nur Basis-URL und API-Schlüssel ändern; die Anfrage- und Antwortfelder bleiben gleich.