Erreurs et nouvelles tentatives
La signification de chaque statut et la marche à suivre.
Les erreurs sont au format JSON avec un champ detail. Fiez-vous au statut et aux en-têtes de nouvelle tentative ; gardez detail pour les journaux et indications.
| Statut | Signification | Marche à suivre |
|---|---|---|
400 | Entrée invalide, moteur inconnu ou routage incorrect | Corrigez la requête ou choisissez un moteur disponible |
401 | PIN ou clé API absent ou incorrect | Envoyez les identifiants |
403 | L’appelant ne peut pas utiliser une route locale ou administrateur | Utilisez loopback ou une route autorisée |
409 | Un modèle ou état requis manque | Installez le modèle recommandé ou résolvez le conflit |
422 | Le corps ne passe pas la validation | Corrigez les noms, types ou limites des champs |
429 | La file GPU est pleine | Attendez Retry-After, puis réessayez |
500 | Défaillance inattendue du moteur ou du serveur | Journalisez detail ; réessayez uniquement si cela est sûr |
503 | Chargement du moteur ou génération temporairement indisponible | Respectez Retry-After |
504 | Une transcription ou génération protégée a expiré | Réessayez une fois ; réduisez la tâche si cela se répète |
Nouvelles tentatives
Réessayez 429, les 503 réessayables et 504 avec un délai exponentiel plafonné. VoiceStudio peut envoyer :
Retry-After: 30
X-OmniVoice-Retryable: trueNe réessayez pas automatiquement 400, 401, 403 ou 422. Un 409 exige d’abord l’installation d’un modèle ou une autre modification explicite.
Pour le doublage et les tâches par lots, reprenez depuis l’état de la tâche après une coupure au lieu de téléverser à nouveau le média.