Codes d’erreur

Ce que signifie chaque code de statut, et que faire.

Format des erreurs

Toutes les erreurs renvoient un JSON de la forme :

json

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Balance Exhausted"
  }
}

Données de référence
Code	error.type	Signification	Que faire
401	authentication_error	La clé API a été copiée avec des guillemets autour, ou des guillemets typographiques.	Retirez tous les guillemets et passez la valeur mdf-… brute. Voir Authentification pour le bon format d’en-tête.
403	permission_denied	La requête a été refusée pour cette clé.	Contactez le support : support@minedom-france.fr.
404	not_found_error	Route ou chemin de point d’accès inconnu.	Vérifiez le chemin du point d’accès.
429	rate_limit_error	Solde épuisé — la clé n’a plus de crédit.	Ne réessayez pas. Rechargez la clé API-AI existante, puis renvoyez la requête.
500	api_error	Réservé. La passerelle n’émet pas de 500 actuellement — les erreurs internes apparaissent en 502 / 503 / 504.	Si vous en voyez une, réessayez avec un délai croissant (500 ms / 1 s / 2 s) et signalez-la.
502	upstream_error	L’amont a renvoyé une erreur 5xx, souvent sur des cas limites de tool_choice.	La couche de compatibilité réessaie déjà 2 fois — si vous la voyez côté client, réessayez une fois.
503	overloaded_error	La capacité amont est temporairement saturée (« no available accounts »).	Réessayez avec un délai croissant ; c’est un signal temporaire de capacité amont.
504	timeout_error	L’amont n’a pas renvoyé d’en-têtes en 120 s.	Passez en streaming pour les appels longs non-streamés — voir /docs/guides/streaming.

5xx. Délai exponentiel : 500 ms · 1 s · 2 s. Arrêtez après trois tentatives.
429 — Solde épuisé. Réessayer n’aidera pas ; rechargez d’abord la clé API-AI existante.
504 sur une longue requête non-streamée. Activez stream: true pour que le premier événement arrive avant le délai d’attente des en-têtes.

Dernière mise à jour : 2 octobre 2026Une erreur ? support@minedom-france.fr