Erreurs et débogage

RouteAPI essaie de retourner une structure d’erreur unifiée afin d’aider le client à identifier l’origine de l’erreur et le traitement adapté.

Structure d’erreur standard

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Codes d’état courants

Code d’état	Type	Causes fréquentes	Traitement recommandé
400	Erreur de requête	Format de paramètre incorrect, paramètre non pris en charge par le modèle	Vérifiez le corps de requête et les capacités du modèle
401	Erreur d’authentification	Token manquant, incorrect ou supprimé	Vérifiez Authorization
402	Erreur de solde	Solde utilisateur insuffisant ou quota Token épuisé	Rechargez ou ajustez le quota
404	Erreur de chemin	Endpoint inexistant	Vérifiez l’URL
429	Limitation	Limite utilisateur, Token ou système déclenchée	Réduisez la concurrence ou ajustez la limite
500	Erreur système	Erreur interne RouteAPI	Consultez les journaux de service

Ordre de diagnostic

1. Confirmez l’URL de requête, le Token et l’ID de modèle.
2. Confirmez le solde, le quota et les droits d’accès de l’utilisateur propriétaire du Token.
3. Consultez les journaux d’utilisation dans la console pour vérifier si la requête est entrée dans RouteAPI.
4. Pour une requête en streaming, vérifiez que le client traite correctement SSE.

Erreurs côté service et erreurs locales

RouteAPI est un système de passerelle ; les erreurs peuvent provenir de trois couches :

Couche	Exemple
Client	JSON de corps de requête incorrect, Token manquant
RouteAPI	Solde insuffisant, absence de droit
Service de modèle	Limitation du service, service indisponible, modèle retiré

En production, il est recommandé d’enregistrer en même temps :

• Heure de la requête
• Token ou ID utilisateur
• ID de modèle
• Code d’état HTTP
• Code d’erreur retourné par RouteAPI
• Information d’erreur dans les journaux d’utilisation de la console