Tous les modèles, capacités et tarifs

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": "billing_error",
    "code": "insufficient_quota",
    "message": "Solde insuffisant : rechargez votre clé sur https://api-ai.fr/pricing — Insufficient balance: top up your key at https://api-ai.fr/pricing"
  }
}

Codes de statut

Données de référence
Codeerror.typeSignificationQue faire
401authentication_errorLa 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.
402billing_errorSolde épuisé — la clé n’a plus de crédit.Ne réessayez pas. Rechargez la clé API-AI existante, puis renvoyez la requête.
403permission_deniedLa requête a été refusée pour cette clé.Contactez le support : admin@minedom-france.fr.
404not_found_errorRoute ou chemin de point d’accès inconnu.Vérifiez le chemin du point d’accès.
429rate_limit_errorTrop de requêtes : le débit autorisé pour cette clé est dépassé.Attendez la durée indiquée par l’en-tête Retry-After, puis réessayez en espaçant vos requêtes.
500api_errorRé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.
502upstream_errorL’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.
503overloaded_errorLa capacité amont est temporairement saturée (« no available accounts »).Réessayez avec un délai croissant ; c’est un signal temporaire de capacité amont.
504timeout_errorL’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.

Stratégie de nouvelles tentatives

  • 5xx. Délai exponentiel : 500 ms · 1 s · 2 s. Arrêtez après trois tentatives.
  • 402 — 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 ? admin@minedom-france.fr