Erreurs — Gamra

Toutes les erreurs utilisent l'enveloppe OpenAI :

{
  "error": {
    "message": "Insufficient balance.",
    "type": "insufficient_quota",
    "code": "insufficient_quota"
  }
}

Les codes#

HTTP	`code`	Que faire
`401`	`missing_authorization`	L'en-tête `Authorization` est absent.
`401`	`invalid_authorization`	L'en-tête est mal formé — attendu : `Bearer <clé>`.
`401`	`invalid_api_key`	Clé inconnue ou révoquée. Redemander une authentification.
`403`	`account_inactive`	Le compte n'est pas actif. Nous contacter.
`403`	`model_not_allowed`	Votre formule n'ouvre pas ce modèle. Changer de modèle ou de formule.
`402`	`insufficient_quota`	Portefeuille vide. Recharger.
`402`	`spend_cap_exceeded`	Plafond mensuel atteint. Le relever ou le retirer.
`429`	`rate_limit_exceeded`	Respecter l'en-tête `Retry-After` et réessayer.
`404`	`model_not_found`	Modèle inconnu. Rafraîchir la liste via `/v1/models`.
`400`	`invalid_body`	Corps de requête invalide.
`400`	`model_lacks_vision`	Image envoyée à un modèle sans vision. Non facturé.
`502`	`upstream_unreachable`	Incident transitoire en amont. Réessayer avec un retrait exponentiel.

Ordre des contrôles#

Les vérifications s'enchaînent dans un ordre délibéré : débit autorisé avant solde. Une formule qui n'ouvre pas un modèle est une condition permanente, et demander de recharger pour une requête qui sera de toute façon refusée est le mauvais message dans le mauvais ordre.

Toujours enregistrer l'identifiant#

Chaque réponse porte x-gamra-request-id. C'est l'identifiant que le registre de consommation utilise également comme clé d'idempotence — sans lui, une requête contestée ne peut pas être retrouvée.