Erreurs
Tous les statuts HTTP et codes d’erreur renvoyés par l’API Cheapest Imagen, leur signification, s’ils sont facturés et que faire ensuite.
Les erreurs ont la même forme que celles d’OpenAI :
{
"error": {
"message": "Not enough credits for this request.",
"type": "invalid_request_error",
"param": null,
"code": "insufficient_credits"
}
}Chaque réponse porte un en-tête x-request-id. Indiquez-le lorsque vous contactez le support.
| Statut | code | Signification | Que faire |
|---|---|---|---|
| 400 | missing_required_parameter | Un champ obligatoire est absent | Ajoutez le champ indiqué dans param |
| 400 | invalid_value | Un champ a une valeur non acceptée | Corrigez le champ indiqué dans param |
| 400 | unsupported_parameter | Le champ n’est pas disponible, ou pas sur ce modèle (par exemple svg sur un modèle sans sortie SVG) | Retirez le champ ou choisissez un modèle qui le prend en charge |
| 400 | model_not_found | Le modèle n’existe pas ou n’est pas ouvert | Utilisez un modèle de GET /v1/models |
| 400 | moderation_blocked | Le prompt ou l’image a été refusé par les contrôles de contenu | Changez le prompt. Non facturé, sauf sur les canaux stables Nano Banana (-1k, -2k, -4k) |
| 401 | invalid_api_key | La clé est absente ou incorrecte | Vérifiez l’en-tête Authorization |
| 402 | insufficient_credits | Crédits insuffisants | Rechargez votre compte |
| 403 | account_suspended | Le compte ou la clé est désactivé | Contactez le support |
| 409 | idempotency_key_in_use | L’Idempotency-Key a déjà été utilisée | Attendez la première requête, ou utilisez une nouvelle clé |
| 413 | request_too_large | La requête ou une image est trop volumineuse | Envoyez des images plus petites ou moins nombreuses |
| 429 | rate_limit_exceeded | Plus de 300 requêtes en une minute | Ralentissez et réessayez |
| 429 | concurrency_limit_exceeded | Plus de 50 requêtes en même temps | Attendez qu’une requête se termine |
| 429 | moderation_paused | Plus de 10 requêtes refusées en une heure | Attendez une heure |
| 502 | upstream_error | L’image n’a pas pu être générée | Réessayez. Non facturé |
| 504 | upstream_timeout | La génération a pris plus de 420 secondes | Réessayez. Non facturé |
Quand vous êtes facturé
Uniquement pour les images que vous recevez. Les requêtes échouées, expirées et refusées ne coûtent rien. L’exception : les canaux stables Nano Banana (-1k, -2k, -4k) facturent les images refusées pour leur contenu, parce que le fournisseur les facture.
Limites de débit et génération en masse
Les limites de l’API Cheapest Imagen (300 par minute, 50 à la fois), ce que signifie une erreur 429, et comment générer des milliers d’images sans double facturation.
Migrer depuis OpenAI
Passez votre code de l’API OpenAI Images à Cheapest Imagen en changeant seulement l’URL de base et la clé API ; les champs de requête et de réponse restent les mêmes.