Erreurs
Les erreurs incluent un code lisible par machine et un message. Distinguez une requête rejetée d’un résultat incertain qui a peut-être déjà consommé des ressources du fournisseur.
Format des erreurs
{
"error": {
"message": "Insufficient available credit for this request. Add credit or resolve pending reservations.",
"type": "invalid_request_error",
"code": "insufficient_credit"
}
}Utilisez le x-request-id de la réponse et vos enregistrements d’activité pour examiner une requête. N’incluez jamais la clé secrète ni le contenu de la conversation dans un rapport d’assistance.
Codes de statut
| Statut | Signification / action |
|---|---|
| 400 | Corps invalide, champs inconnus, limite de contexte ou capacité non prise en charge. |
| 401 | Clé Bearer manquante, invalide ou révoquée. |
| 402 | Crédit disponible insuffisant ou plafond de dépenses de la clé API atteint. |
| 403 | Compte indisponible ou modèle absent de la liste autorisée pour la clé. |
| 404 | Point de terminaison inconnu ou ID de modèle non approuvé. |
| 409 | Une référence d’idempotence a déjà été utilisée. |
| 413 / 415 | Corps trop volumineux ou type de contenu autre que application/json. |
| 429 | Limite de débit, de requêtes ou de concurrence. Attendez l’intervalle Retry-After avant de réessayer ; les réservations en attente peuvent nécessiter un rapprochement. |
| 502 | Défaillance du fournisseur, flux invalide ou utilisation indisponible. |
| 503 | Maintenance, disponibilité du fournisseur ou configuration de lancement. |
Résultats incertains
Un dépassement de délai en amont ou une réponse usage_unavailable peut laisser une réservation en attente. Ces erreurs incluent X-Should-Retry: false pour empêcher les répétitions automatiques du SDK. Les codes d’erreur du fournisseur distinguent les modèles indisponibles, les paramètres invalides, l’authentification, les quotas et la limitation de débit sans révéler de détails privés du fournisseur. Examinez l’activité et rapprochez le premier résultat avant de décider d’envoyer un nouvel appel.
Idempotence
Une valeur facultative Idempotency-Key contient 1–128 lettres, chiffres, points, traits de soulignement, deux-points ou tirets. La réutilisation d’une référence renvoie 409 et ne relance pas l’inférence. Ce mécanisme empêche les doublons ; il ne rejoue pas une réponse en cache.