Developer guide
Codes d’erreur
Actions et règles de nouvelle tentative par code d’état
Cette page récapitule les codes d’état renvoyés par la passerelle, leur signification et les actions à effectuer pour chaque code.
Si l’amont renvoie un code 4xx ou 5xx, ce code est transmis tel quel. Dans les autres cas, le tableau ci-dessous s’applique.
La forme du corps des erreurs pour les deux normes compatibles, les règles de error.type compatible avec Anthropic, ainsi que l’écran de la console permettant de vérifier les limites et l’utilisation sont également présentés.
Code d’état
| Code | Signification | Action |
|---|---|---|
| 400 | Erreur dans les paramètres de la requête. La valeur de limit de la liste des modèles compatibles avec Anthropic est en dehors de la plage 1~1000, ou une tentative a été faite de reprendre une réponse enregistrée avec GET /responses/{responseId}?stream=true | Corrigez la valeur pour la ramener dans la plage autorisée. Consultez les réponses enregistrées sans stream. |
| 401 | Clé absente, expirée ou révoquée | Vérifiez l’état de la clé dans l’écran des clés API, puis contrôlez le nom de l’en-tête et le préfixe Bearer. |
| 403 | Accès au modèle non autorisé, limite d’utilisation dépassée, crédits insuffisants ou absence de statut de propriétaire de la voix | error.message permet d’identifier la cause. Consultez les valeurs dans l’écran de la section ci-dessous consacrée à la vérification des limites et de l’utilisation. |
| 404 | Modèle inexistant ou inaccessible avec cette clé (y compris les modèles dont la prise en charge a pris fin), chemin inexistant ou résultat CleviDrive dont la période de conservation de 3 jours est dépassée | Vérifiez d’abord la liste des modèles disponibles avec GET /models. Comparez le chemin avec le tableau de la page Effectuer un appel API. |
| 408 · 409 · 413 | Délai d’attente dépassé en amont, congestion ou taille de requête excessive. Pour les chemins audio et voix, le délai maximal est de 5 minutes et la taille maximale de la requête est de 28 MiB | Si 409 contient Retry-After, attendez pendant la durée indiquée. Pour 413, divisez la requête avant de l’envoyer. |
| 429 | Le fournisseur en amont applique une limitation de débit | Si Retry-After est présent, respectez-le tel quel. Sinon, effectuez une nouvelle tentative avec un backoff exponentiel. |
| 5xx | Erreur temporaire de la passerelle ou de l’amont (y compris 503) | Effectuez une nouvelle tentative avec un backoff exponentiel. Si le problème persiste, signalez-le via l’aide et le contact, en indiquant X-Request-Id. |
Nouvelle tentative
La passerelle ne génère pas elle-même de 429 et ne réessaie pas discrètement les réponses de l’amont ni ne les met en file d’attente.
L’attente et les nouvelles tentatives sont gérées par le client.
| Code | Délai d’attente | Ensuite |
|---|---|---|
| 409 | Ce délai s’il y a un en-tête Retry-After | Renvoyer la même requête. |
| 429 | Ce délai s’il y a un en-tête Retry-After, sinon utiliser un backoff exponentiel | Renvoyer la même requête. |
| 5xx | Backoff exponentiel | Contacter le support si le problème persiste. |
| 413 | Aucun délai d’attente | Diviser la requête. |
Corps de l’erreur
La structure du corps de l’erreur varie selon la spécification. Les erreurs en amont sont résumées en ne conservant que le message, puis transmises ; la pile d’appels et les champs internes ne sont pas transmis.
Corps de la réponse du chemin compatible avec OpenAI.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Corps de la réponse du chemin compatible avec Anthropic. error.type est défini à partir du code d’état.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Code d’état | error.type |
|---|---|
| 400 | invalid_request_error |
| 401 | authentication_error |
| 403 | permission_error |
| 404 | not_found_error |
| 413 | request_too_large |
| 429 | rate_limit_error |
| 529 | overloaded_error |
| Autres codes | api_error |
Vérifier les limites et l’utilisation
Les limites varient selon chaque espace de travail. Après avoir vérifié la raison du code 403 dans error.message, consultez les valeurs dans les écrans ci-dessous.
| Élément à vérifier | Écran de la console |
|---|---|
| Limite appliquée à mon espace de travail | Limite d’utilisation allouée dans la vue d’ensemble |
| Plage autorisée par le forfait et solde | Forfait et crédits |
| Utilisation réelle (appels par modèle et par clé, crédits estimés déduits) | Utilisation |
| État de la clé (expiration ou révocation) | Clé API |