Codes d'erreur de l'API

Codes d'erreur courants lors de l'appel de l'API Kimi et comment les résoudre.

Référence des codes d'erreur

Code d'erreurSignificationRésolution
400Requête incorrecteVérifiez le format du corps de la requête, les noms et types de paramètres. Causes fréquentes : JSON mal formé, paramètres obligatoires manquants, valeurs hors plage.
401Non autoriséVérifiez que la clé API est correcte, qu'elle n'est ni expirée ni désactivée. Confirmez le format de l'en-tête : Authorization: Bearer <your-api-key>.
403Interdit (solde insuffisant)Solde du compte épuisé — rechargez-le dans la console. Le compte peut aussi être restreint ; contactez le support si nécessaire.
404IntrouvableVérifiez le chemin de l'URL de la requête et le nom du modèle. Confirmez que le point de terminaison est https://api.moonshot.ai/v1/....
429Trop de requêtesLimite de débit (rate limit) dépassée. Réduisez la fréquence, mettez en place un backoff exponentiel, ou contactez le support pour des limites plus élevées.
500Erreur interne du serveurProblème temporaire du serveur — réessayez plus tard. Si le problème persiste, contactez [email protected] en précisant le request_id.

Conseils de dépannage généraux

  1. Consultez le message d'erreur complet : le JSON de réponse inclut error.message avec une description détaillée.
  2. Notez le request_id : il aide le support à localiser rapidement le problème.
  3. Reportez-vous à la documentation officielle : assurez-vous que vos appels correspondent à la documentation sur platform.kimi.ai.
  4. Mettez en place une logique de réessai : pour les erreurs 429 et 500, utilisez un backoff exponentiel.