Format de Reponse d’Erreur
Lorsqu’une tache echoue (status: "failed"), la reponse inclut un objet error :
| Champ | Type | Description |
|---|---|---|
error.code | string | Identifiant du code d’erreur. Voir la liste complete ci-dessous |
error.message | string | Description d’erreur conviviale avec conseils de depannage |
Apercu des Codes d’Erreur
Erreurs Client (Corrigibles par l'Utilisateur)
Erreurs Client (Corrigibles par l'Utilisateur)
| Code d’Erreur | Description | Reessayable |
|---|---|---|
content_policy_violation | Le contenu viole les politiques de securite | Corriger le contenu, puis reessayer |
invalid_parameters | Parametres de requete invalides | Corriger les parametres, puis reessayer |
image_processing_error | Echec du traitement de l’image | Utiliser une autre image |
image_dimension_mismatch | Les dimensions de l’image ne correspondent pas a la requete | Redimensionner l’image, puis reessayer |
request_cancelled | La requete a ete annulee | Resoumettre |
Erreurs Serveur (Reessayer Plus Tard)
Erreurs Serveur (Reessayer Plus Tard)
| Code d’Erreur | Description | Reessayable |
|---|---|---|
generation_failed_no_content | Le modele n’a pas pu generer de contenu | Essayer un autre prompt |
service_error | Erreur interne du service | Recuperation automatique, reessayer plus tard |
generation_timeout | Le traitement de la tache a expire | Reessayer plus tard |
resource_exhausted | Ressources en amont temporairement epuisees | Recuperation automatique, reessayer plus tard |
quota_exceeded | Limite de debit ou quota depasse | Reduire la frequence, reessayer plus tard |
service_unavailable | Service temporairement indisponible | Recuperation automatique, reessayer plus tard |
resource_not_found | ID de tache invalide ou expire | Verifier l’ID de tache |
unknown_error | Erreur non classifiee | Contacter le support |
Details des Codes d’Erreur
content_policy_violation
Violation de la Politique de Contenu
Votre requete a ete bloquee par les filtres de securite. C’est le type d’erreur le plus courant, couvrant les scenarios suivants :
| Sous-type | Description | Message d’exemple |
|---|---|---|
| Personnes photorealistes | L’image telechargee contient de vrais visages humains | photorealistic people detected |
| Ressemblance avec des celebrites | Implique des celebrites ou des personnalites publiques | celebrity detected in image |
| Droit d’auteur/Marque | Implique des logos de marque, des marques deposees ou de la PI protegee | third-party content violation |
| Adulte/NSFW | Contient de la nudite ou du contenu sexuellement suggestif | nudity detected |
| Violence/Automutilation | Contient du contenu violent, graphique ou d’automutilation | violence content blocked |
| Protection des mineurs | Implique du contenu sensible lie aux mineurs | minor content not allowed |
| Politique generale | Autres violations de la politique de contenu | content policy violation |
generation_failed_no_content
Echec de Generation
Le modele n’a pas pu produire de contenu pour votre requete. Bien que le format de la requete soit valide, le modele n’a pas pu generer de resultat pendant le traitement.
- Mauvaise qualite du prompt : La description est trop vague ou contradictoire pour que le modele comprenne
- Limites de capacite du modele : Le prompt depasse les capacites de generation du modele
- Problemes du service en amont : Le service du modele sous-jacent a retourne un resultat vide
- Detection de contenu protege : Le prompt ou l’image de reference peut impliquer la suppression de filigranes ou du contenu protege (logos, marques, etc.)
invalid_parameters
Parametres Invalides
Les parametres de la requete ne repondent pas aux exigences du modele.
| Sous-type | Description | Exemple |
|---|---|---|
| Prompt trop long | Le prompt depasse la longueur maximale du modele | Prompt is too long |
| Dimension d’image | La largeur/hauteur ou le rapport d’aspect de l’image est hors limites | image dimensions must be between 240 and 7680 |
| Fichier trop volumineux | Le fichier telecharge depasse la limite de taille | file size exceeds 10MB |
| Format non supporte | Le format du fichier telecharge n’est pas supporte | unsupported file type |
| Duree de video | La duree de la video est hors de la plage supportee par le modele | Video duration must be between 1-30 seconds |
image_processing_error
Echec du Traitement d'Image
Le systeme n’a pas pu traiter l’image d’entree.
- L’URL de l’image n’est pas accessible (authentification requise, restrictions CDN, lien expire)
- Le format d’image n’est pas supporte (par exemple, HEIC, AVIF)
- Le fichier image est corrompu
- Des problemes de reseau ont empeche le telechargement de l’image
image_dimension_mismatch
Inadequation des Dimensions de l'Image
Les dimensions de l’image d’entree ne correspondent pas aux dimensions specifiees dans la requete. Courant dans les scenarios de conversion image vers video.
aspect_ratio=1280x720(16:9) necessite une image paysage de 1280x720aspect_ratio=720x1280(9:16) necessite une image portrait de 720x1280
service_error
Erreur de Service
Un probleme interne s’est produit dans le service en amont. C’est generalement temporaire — le systeme bascule automatiquement vers d’autres routes disponibles.
- Service du modele en amont temporairement indisponible
- Surcharge du serveur / trafic eleve
- Maintenance en cours
- Connexion reseau interrompue
generation_timeout
Delai de Generation Depasse
La tache ne s’est pas terminee dans le delai imparti.
- Charge systeme elevee causant des retards dans la file d’attente
- Complexite elevee de la tache (haute resolution, longue video, etc.)
- Reponse lente du service en amont
quota_exceeded
Quota / Limite de Debit Depasse
Les limites de frequence de requete ou de concurrence ont ete depassees.
- Trop de requetes envoyees en peu de temps (limitation de debit)
- Plusieurs taches en cours de traitement simultanement (limite de concurrence)
- Quota du compte epuise
resource_exhausted
Ressources Epuisees
Les ressources de calcul du service en amont sont temporairement epuisees. Se produit generalement pendant les periodes de pointe d’utilisation du modele.
resource_not_found
Ressource Non Trouvee
L’ID de tache demande n’existe pas ou a expire.
request_cancelled
Requete Annulee
La tache a ete annulee ou interrompue pendant le traitement.
service_unavailable
Service Indisponible
Un probleme d’authentification ou de connexion interne s’est produit. Cette erreur a ete automatiquement enregistree et sera generalement resolue rapidement.
unknown_error
Erreur Inconnue
Une erreur non classifiee. Le systeme n’a pas pu identifier le type d’erreur specifique.
Bonnes Pratiques
Exemple de Gestion des Erreurs
Reessayable vs Non Reessayable
Corriger la Requete Avant de Reessayer
content_policy_violation— Modifier le contenuinvalid_parameters— Corriger les parametresimage_processing_error— Utiliser une autre imageimage_dimension_mismatch— Redimensionner l’image
Sur de Reessayer Directement
generation_failed_no_content— Essayer un autre promptservice_error— Attendre, puis reessayergeneration_timeout— Attendre, puis reessayerresource_exhausted— Recuperation automatiquequota_exceeded— Reduire la frequence, puis reessayer