Format de réponse d’erreur
Toutes les erreurs API renvoient un format JSON cohérent :Types d’erreurs
Gestion des erreurs dans les SDK
Nouvelles tentatives automatiques
Tous les SDK retentent automatiquement les erreurs transitoires (429, 500, 502, 503, 504) avec un backoff exponentiel :Bonnes pratiques
- Attrapez toujours les erreurs — ne laissez pas les échecs API faire planter votre application
- Utilisez les basculements — configurez des modèles de basculement pour les chemins critiques
- Journalisez le request_id — incluez
response.openmodex.request_iddans les rapports d’erreur pour le support - Définissez des timeouts appropriés — plus longs pour les prompts complexes, plus courts pour les requêtes simples
- Gérez les erreurs de streaming — les flux peuvent échouer en cours de réponse ; mettez en tampon le contenu partiel