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

  1. 401 : vérifiez que la valeur Authorization: Bearer correspond à la clé secrète complète sk-live-* et que la clé n'est pas révoquée.
  2. 402 : recharger le crédit dans la console.
  3. 429 : réduire le nombre de requêtes simultanées ou attendre retry-after avant de réessayer.
  4. 5xx : réessayez plus tard ; si le problème persiste, contactez le support technique en indiquant le request_id.

Exemple d'erreur

{
  "error": {
    "message": "insufficient balance",
    "type": "request_error",
    "code": "insufficient_balance",
    "param": null,
    "request_id": "req_8f2a…c91d"
  }
}