Erreurs

Les réponses d'erreur sont du JSON avec une structure cohérente :

{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Daily quota exceeded",
    "retryable": false
  }
}

code est une chaîne stable, lisible par machine — sûre pour brancher sur elle dans le code client. message est lisible par un humain et son libellé peut changer avec le temps. Quelques codes que vous rencontrerez en pratique aujourd'hui : RATE_LIMITED, MODEL_NOT_ALLOWED, CONVERSATION_NOT_FOUND, QUOTA_EXCEEDED, INVALID_REQUEST, FILE_REQUIRED, UNSUPPORTED_FILE_TYPE, FILE_SCAN_FAILED, FILE_NOT_FOUND, PLAN_NOT_FOUND, PLAN_NOT_PURCHASABLE.

Une requête de chat en échec ne diffuse jamais en streaming un message d'erreur brut du prestataire ou interne vers le client — vous obtiendrez un message générique accompagné d'un identifiant de référence, le détail réel étant journalisé côté serveur.