Erreurs et nouvelles tentatives

Lisez conjointement le statut HTTP et le corps de l'erreur JSON. Conservez tout identifiant de requête ou de référence renvoyé par le service ; il permet au support de trouver l'enregistrement correspondant sans recevoir le prompt ou la clé complète.

Codes de statut

Code	Signification	Action
400	JSON, champ ou paramètre invalide, ou requête rejetée	Corrigez la requête ; ne la réessayez pas sans modification
401	Clé manquante, invalide, expirée ou révoquée	Vérifiez Authorization: Bearer <key> et l'environnement prévu
402	Le solde de la clé ne couvre pas le prix de la tâche (veille entreprise, vidéo)	Rechargez le solde, puis renvoyez la requête
403	Le compte ou la clé ne peut pas utiliser le produit ou la route demandé	Vérifiez GET /v1/models et les produits activés pour le compte
404	Route incorrecte ou ressource indisponible	Vérifiez la documentation actuelle et l'identifiant
413	Le corps de la requête est trop volumineux	Réduisez ou divisez l'entrée
422	Une route prise en charge a rejeté la structure soumise	Lisez les problèmes et corrigez le corps
429	Une limite de requêtes, de capacité ou de compte a été atteinte, ou le budget de la clé est épuisé	Attendez et réessayez avec un délai croissant ; si le budget est épuisé, rechargez d'abord
500, 502, 503	Problème temporaire côté service	Réessayez un nombre limité de fois, puis contactez le support

L'API des tâches d'image (/api/v1/jobs/*) fait exception : elle répond avec le statut HTTP 200 et place le code dans le corps, {"code": 422, "msg": "…", "data": null}. Voir Génération d'images.

Politique de nouvelle tentative

Ne réessayez que pour les réponses 429, les réponses 5xx temporaires et les défaillances réseau transitoires. Utilisez un nombre maximal de tentatives faible, un délai d'attente total, des délais croissants tels que 1, 2 et 4 secondes, et une légère variation aléatoire lorsque de nombreux workers peuvent réessayer simultanément.

Ne réessayez pas une requête 400, 401, 402, 403, 404, 413 ou 422 sans modification. Une connexion interrompue nécessite une attention particulière : la requête a peut-être déjà été complétée et a consommé du crédit, donc un doublon automatique peut créer du travail et des coûts supplémentaires.

Quoi journaliser

Enregistrez l'heure approximative et le fuseau horaire, le modèle public, la route, le statut, l'identifiant de requête ou de référence, et l'alias, le préfixe ou les quatre derniers caractères de la clé. Ne journalisez ou n'envoyez jamais la clé complète, les mots de passe, les prompts confidentiels, les traces d'appels ou les noms internes.

Si une nouvelle tentative limitée échoue toujours, contactez support@omev.be avec un exemple nettoyé et les identifiants enregistrés.