Codes d'erreur

Toutes les erreurs sont renvoyées au format OpenAI{ error: { message, type, code } } avec un code HTTP cohérent. Les SDK officiels parsent ce format nativement et lèvent des exceptions typées.

Format d'erreur#format

Tous les status >= 400 renvoient un body JSON de la forme suivante. Le champ code identifie la cause de manière stable, le message est destiné aux humains.

{
  "error": {
    "message": "Modèle \"foo\" inconnu. Modèles disponibles : \"3gk-llm\" (Chat completions), \"3gk-embed\" (Embeddings), \"3gk-rerank\" (Reranking).",
    "type": "model_not_supported",
    "code": "model_not_supported"
  }
}

Codes & causes#codes

Stratégies de retry#strategies

• 400 / 401 / 402 / 413 — ne pas retry. Corriger le payload, la clé, le solde ou la taille de la requête.
• 409 — ne pas retry immédiatement : l'état ne changera qu'à la fin du job. Attendre que le polling renvoie un statut terminal, puis rappeler DELETE.
• 429 — retry avec backoff exponentiel (1 s · 2 s · 4 s…) ; limitez le nombre d'appels simultanés par compte.
• 500 / 502 — retry avec backoff exponentiel (jusqu'à 3 tentatives, 1 s · 4 s · 16 s).
• 503 — l'incident est administratif (modèle par défaut absent, fallback non configuré, tarif du service manquant, file de jobs injoignable). Retry très espacé (dizaines de secondes) ou avertir l'utilisateur final ; ne pas hammerer.
• 504 — réduire max_tokens ou simplifier le prompt. Le timeout par défaut est large (600 s).