🎉 Générations offertes au premier achat de chaque pack — jusqu'à 20 vidéos Lite + 20 images Lite + 10 vidéos Medium + 10 images Pro + 2 vidéos Pro.

Commencer
DreamUtopia
fr

Erreurs et limites

Chaque échec utilise une seule enveloppe. Le code est stable ; le message est un repli en anglais que vous pouvez afficher à un utilisateur.

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

Statuts

  • 400

    Code typique
    invalid_request, prompt_too_long, invalid_reference_image
    Que faire
    Corrigez la requête ; ne réessayez pas sans modification
  • 401

    Code typique
    unauthorized
    Que faire
    Vérifiez la clé ; ne réessayez pas en boucle
  • 402

    Code typique
    insufficient_credits
    Que faire
    Rechargez vos crédits ; ne réessayez jamais
  • 403

    Code typique
    unauthorized
    Que faire
    Création de clé non payée, ou audio demandé sans premium
  • 404

    Code typique
    not_found
    Que faire
    Tâche inconnue, ou n'appartenant pas à ce compte
  • 409

    Code typique
    invalid_request
    Que faire
    Conflit de Idempotency-Key ; utilisez une nouvelle clé
  • 413 / 415

    Code typique
    invalid_request / unsupported_image_type
    Que faire
    Téléchargez un fichier JPEG, PNG ou WebP plus petit
  • 429

    Code typique
    rate_limited
    Que faire
    Attendez Retry-After
  • 500 / 503

    Code typique
    internal
    Que faire
    Réessayer avec temporisation

Une génération échouée est une réponse de tâche 200 avec status: "failed" et un objet error dont le code est internal. Une tâche terminée est définitive : ne la soumettez pas à nouveau.

Politique de nouvelle tentative

  • Réessayez uniquement les réponses HTTP 429, timeout et internal.
  • Ne réessayez jamais insufficient_credits, et ne soumettez jamais à nouveau un job qui s'est déjà terminé en failed.
  • Utiliser une clé d’idempotence (Idempotency-Key) lors des créations afin qu’une nouvelle tentative ne puisse pas facturer deux fois.
  • Reculez de façon exponentielle, avec un peu d'aléatoire, en commençant autour d'une seconde.

Limites de débit

Les limites sont par clé, dans des fenêtres fixes d'une minute, sauf indication contraire. Valeurs par défaut :

  • 60 requêtes/minute au total.
  • 10 générations créées/minute.
  • 5 téléversements/minute.
  • 120 requêtes GET /v1/models par minute et par IP client (la route est publique).
  • 5 créations de clé API/heure par compte.

Un 429 comporte X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset et Retry-After.

Disponibilité

Si /v1 est temporairement indisponible, chaque route répond 503 avec le code internal. Réessayez plus tard avec un backoff.

© 2026 DreamUtopia. Tous droits réservés.