Erreurs

Les requêtes ayant échoué renvoient JSON avec un objet error. Le statut HTTP est le premier signal ; les champs message et code nomment la panne réelle.

JSON

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Codes d’état courants

Statut	Cause typique
400	JSON invalide, champ non pris en charge ou mauvais point de terminaison pour le modèle
401	Clé API manquante ou invalide
403	La clé ne peut pas utiliser ce modèle ou ce groupe
404	Chemin inconnu ou tâche manquante
429	Limite de débit
499	Le client a annulé la demande
5xx	Défaillance du fournisseur de services ou de la passerelle

Les requêtes d’image et de vidéo envoyées au mauvais protocole renvoient 400 avec unsupported_endpoint et nomment l’API requise. La conversion de protocole silencieuse concerne uniquement les modèles de texte.

Les diagnostics, tentatives et solutions de secours plus longs appartiennent aux articles techniques du site principal, à commencer par Dépannage des erreurs de l’API AI.