🎉 Gratis-Generierungen beim Erstkauf jedes Pakets — bis zu 20 Lite-Videos + 20 Lite-Bilder + 10 Medium-Videos + 10 Pro-Bilder + 2 Pro-Videos.

Loslegen
DreamUtopia
de

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.

Antwort
{
  "error": {
    "code": "insufficient_credits",
    "message": "You need more credits to generate."
  }
}

Status

  • 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- und internal-Antworten.
  • Wiederhole niemals insufficient_credits, und reiche niemals einen Job erneut ein, der bereits als failed beendet wurde.
  • Verwende einen Idempotency-Key bei 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.

© 2026 DreamUtopia. Alle Rechte vorbehalten.