Fehler und Grenzen
Jeder Fehler verwendet einen einheitlichen Rahmen. Der Code ist stabil; die Meldung ist ein englischer Fallback, den du einem Benutzer anzeigen kannst.
{
"error": {
"code": "insufficient_credits",
"message": "You need more credits to generate."
}
}Status
| HTTP | Typischer Code | Was zu tun ist |
|---|---|---|
| 400 | invalid_request, prompt_too_long, invalid_reference_image | Korrigiere die Anfrage; nicht unverändert erneut versuchen |
| 401 | unauthorized | Prüfe den Schlüssel; versuche es nicht in einer Schleife erneut |
| 402 | insufficient_credits | Guthaben aufladen; niemals erneut versuchen |
| 403 | unauthorized | Unbezahlte Schlüsselerstellung oder Audio ohne Premium angefordert |
| 404 | not_found | Unbekannter Auftrag oder nicht zu diesem Konto gehörend |
| 409 | invalid_request | Idempotency-Key-Konflikt; verwenden Sie einen neuen Schlüssel |
| 413 / 415 | invalid_request / unsupported_image_type | Lade ein kleineres JPEG, PNG oder WebP hoch |
| 429 | rate_limited | Warte auf Retry-After |
| 500 / 503 | internal | Mit Backoff erneut versuchen |
400
- Typischer Code
invalid_request,prompt_too_long,invalid_reference_image- Was zu tun ist
- Korrigiere die Anfrage; nicht unverändert erneut versuchen
401
- Typischer Code
unauthorized- Was zu tun ist
- Prüfe den Schlüssel; versuche es nicht in einer Schleife erneut
402
- Typischer Code
insufficient_credits- Was zu tun ist
- Guthaben aufladen; niemals erneut versuchen
403
- Typischer Code
unauthorized- Was zu tun ist
- Unbezahlte Schlüsselerstellung oder Audio ohne Premium angefordert
404
- Typischer Code
not_found- Was zu tun ist
- Unbekannter Auftrag oder nicht zu diesem Konto gehörend
409
- Typischer Code
invalid_request- Was zu tun ist
Idempotency-Key-Konflikt; verwenden Sie einen neuen Schlüssel
413 / 415
- Typischer Code
invalid_request/unsupported_image_type- Was zu tun ist
- Lade ein kleineres JPEG, PNG oder WebP hoch
429
- Typischer Code
rate_limited- Was zu tun ist
- Warte auf
Retry-After
500 / 503
- Typischer Code
internal- Was zu tun ist
- Mit Backoff erneut versuchen
Eine fehlgeschlagene Generierung ist eine 200-Job-Antwort mit status: "failed" und einem error-Objekt mit dem Code internal. Ein abgeschlossener Job ist endgültig: reiche ihn nicht erneut ein.
Wiederholungsrichtlinie
- Wiederhole nur HTTP-
429-,timeout- undinternal-Antworten. - Wiederhole niemals
insufficient_credits, und reiche niemals einen Job erneut ein, der bereits alsfailedbeendet wurde. - Verwende einen
Idempotency-Keybei Erstellungen, damit ein erneuter Versuch nicht doppelt berechnet werden kann. - Warte exponentiell mit Jitter, beginnend bei etwa einer Sekunde.
Ratenlimits
Die Limits gelten pro Schlüssel in festen Ein-Minuten-Fenstern, sofern nicht anders angegeben. Standardwerte:
- 60 Anfragen/Minute insgesamt.
- 10 Generierungen/Minute.
- 5 Uploads/Minute.
- 120
GET /v1/models-Anfragen/Minute pro Client-IP (die Route ist öffentlich). - 5 API-Schlüssel-Erstellungen/Stunde pro Konto.
Ein 429 trägt X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset und Retry-After.
Verfügbarkeit
Wenn /v1 vorübergehend nicht verfügbar ist, antwortet jede Route mit 503 und dem Code internal. Versuche es später mit Backoff erneut.