Reference des erreurs

Format d'erreur normalise et codes les plus frequents.

Format

Toute erreur suit la meme structure JSON, quel que soit l'endpoint :

json

{
  "error": {
    "code": "insufficient_credits",
    "message": "Solde de credits insuffisant ou budget mensuel du projet depasse.",
    "request_id": "9480fe92-f68e-4731-b98e-d35a5e8b9819",
    "details": {}
  }
}

request_id identifie la requete de bout en bout a travers les services — utile a fournir si vous nous contactez pour une erreur inattendue.

Codes frequents

HTTP	code	Signification
401	missing_api_key	En-tete Authorization absent.
401	invalid_api_key	Cle API invalide, revoquee, ou expiree.
403	insufficient_scope	La cle n'a pas le scope requis pour cette categorie.
403	not_a_member	Vous n'appartenez pas a cette organisation.
403	csrf_check_failed	En-tete de securite manquant (session cookie, hors usage cle API).
404	model_not_found	routing_strategy "manual" avec un model inconnu du catalogue.
404	no_model_available	Aucun modele ne correspond aux criteres demandes.
402	insufficient_credits	Solde de credits insuffisant ou budget mensuel du projet depasse.
409	conflict	Etat incompatible avec l'action (ex. conversation d'agent pas idle).
422	validation_error	Corps de requete invalide (champ manquant, mauvais type...).
429	rate_limit_exceeded	Trop de requetes pour cette cle — voir Limites de debit.
503	all_providers_unavailable	Tous les fournisseurs candidats ont echoue (voir Routage & fallback).

Dans les SDKs

Les SDKs officiels convertissent chaque tranche de statut HTTP en une classe d'erreur typee (AuthenticationError, PermissionDeniedError, NotFoundError, InsufficientCreditsError, ConflictError, ValidationError, RateLimitError, ServerError), toutes exposant .code, .status, .requestId et .details en plus du message. Voir SDK JavaScript / SDK Python.