Codes d'erreur
Les requêtes ayant échoué renvoient une structure d'erreur unifiée ; le champ code correspond à un code lisible par machine.
Tableau des codes d'erreur
| HTTP | code | Facturé | Description |
|---|---|---|---|
| 400 | invalid_request |
Non | Paramètres de requête non valides |
| 401 | invalid_api_key |
Non | Clé API manquante ou non valide |
| 402 | insufficient_balance |
Non | Solde insuffisant — recharger |
| 403 | model_not_allowed |
Non | Modèle non autorisé pour cette clé |
| 429 | rate_limit_exceeded |
Non | Limite de débit atteinte — réessayer plus tard |
| 500 | billing_settlement_error |
Rapprochement asynchrone | Échec du règlement de facturation |
| 502 | upstream_error |
Généralement non | Erreur du service en amont |
| 503 | model_provider_unavailable |
Non | Service du modèle temporairement indisponible |
| 504 | upstream_timeout |
Généralement non | Délai d'attente en amont dépassé |
Dépannage
401: vérifiez que la valeurAuthorization: Bearercorrespond à la clé secrète complètesk-live-*et que la clé n'est pas révoquée.402: recharger le crédit dans la console.429: réduire le nombre de requêtes simultanées ou attendreretry-afteravant de réessayer.5xx: réessayez plus tard ; si le problème persiste, contactez le support technique en indiquant lerequest_id.
Exemple d'erreur
{
"error": {
"message": "insufficient balance",
"type": "request_error",
"code": "insufficient_balance",
"param": null,
"request_id": "req_8f2a…c91d"
}
}