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.
{
"error": {
"code": "insufficient_credits",
"message": "You need more credits to generate."
}
}Statuts
| HTTP | Code typique | Que faire |
|---|---|---|
| 400 | invalid_request, prompt_too_long, invalid_reference_image | Corrigez la requête ; ne réessayez pas sans modification |
| 401 | unauthorized | Vérifiez la clé ; ne réessayez pas en boucle |
| 402 | insufficient_credits | Rechargez vos crédits ; ne réessayez jamais |
| 403 | unauthorized | Création de clé non payée, ou audio demandé sans premium |
| 404 | not_found | Tâche inconnue, ou n'appartenant pas à ce compte |
| 409 | invalid_request | Conflit de Idempotency-Key ; utilisez une nouvelle clé |
| 413 / 415 | invalid_request / unsupported_image_type | Téléchargez un fichier JPEG, PNG ou WebP plus petit |
| 429 | rate_limited | Attendez Retry-After |
| 500 / 503 | internal | Réessayer avec temporisation |
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,timeoutetinternal. - Ne réessayez jamais
insufficient_credits, et ne soumettez jamais à nouveau un job qui s'est déjà terminé enfailed. - 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/modelspar 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.