Documentation APIDocumentation API
Erreurs
Enveloppes d'erreur stables, codes et statuts HTTP
Les erreurs utilisent une enveloppe fixe et ne contiennent jamais de diagnostics privés :
{
"success": false,
"error": {
"code": "INVALID_REQUEST",
"message": "The request is invalid.",
"request_id": "req_012345"
}
}| HTTP | Code | Signification |
|---|---|---|
| 400 | INVALID_REQUEST | corps, champ de formulaire, en-tête ou image invalide |
| 400 | CONTENT_POLICY_VIOLATION | la requête ne peut pas être traitée |
| 401 | UNAUTHORIZED | clé API absente ou invalide |
| 402 | INSUFFICIENT_CREDITS | solde disponible insuffisant |
| 403 | FORBIDDEN | portée requise ou accès bêta manquant |
| 404 | JOB_NOT_FOUND | job inexistant ou appartenant à un autre compte |
| 409 | IDEMPOTENCY_CONFLICT | clé réutilisée avec un contenu différent |
| 409 | JOB_CANCELED | le job a été annulé |
| 429 | RATE_LIMIT_EXCEEDED | limite de requêtes dépassée |
| 500 | JOB_FAILED | le job d'image n'a pas pu aboutir |
| 500 | INTERNAL_ERROR | la requête n'a pas pu aboutir |
Le rejet pour taille d'envoi utilise HTTP 413 avec INVALID_REQUEST.
Considérez 429 et les jobs non terminés comme réessayables en respectant le
délai documenté. Pour les autres erreurs, modifiez la requête ou contactez le
support avec request_id ; n'analysez pas le message destiné aux humains dans
votre logique applicative.