Codes d’erreur courants

Lorsque vous rencontrez un code de statut, commencez par identifier le type de problème, puis diagnostiquez-le par ordre de priorité

Beaucoup de personnes, dès qu’elles voient une erreur, supposent immédiatement que la plateforme a un problème. En réalité, la plupart des erreurs d’intégration à MoleAPI peuvent être localisées rapidement à l’aide du code de statut + des options de configuration.

Méthode de diagnostic recommandée

Ne remettez pas toute la configuration en cause dès le départ. Il est recommandé de procéder dans cet ordre :

Vérifiez d’abord le code de statut
Déterminez ensuite s’il s’agit d’un problème d’identité, de permission, d’adresse ou de contenu de requête
Revenez enfin dans la console pour vérifier la configuration correspondante

Tableau récapitulatif des codes d’erreur

Code de statut	Signification courante	Ce que vous devez vérifier en priorité
400	Erreur dans les paramètres de la requête	Structure JSON, type des champs, compatibilité du modèle avec ce paramètre
401	Échec de l’authentification	Vérifier si l’API Key est correcte, s’il y a un espace en trop, ou si elle a expiré
403	Permissions insuffisantes	Permissions du modèle, groupe, liste blanche IP, limite de la Key
404	Erreur d’adresse ou de routage	Vérifier si la Base URL est correcte, si `/v1` n’a pas été omis, ou si le chemin contient une faute
429	Limitation de débit ou problème de quota	Fréquence des requêtes, concurrence, solde, quota ou limite atteinte
500	Erreur côté serveur	Réessayez d’abord en conservant les informations de la requête ; si le problème persiste, contactez le support

Comprendre les codes de statut

400 : le problème vient de la requête elle-même

Cette erreur indique généralement que :

la structure de votre requête est incorrecte
le type d’un champ est invalide
vous avez transmis au modèle un paramètre qu’il ne prend pas en charge

Si vous avez récemment changé de modèle, de SDK, ou copié l’exemple de quelqu’un d’autre, commencez par vérifier ce point.

401 : problème avec l’API Key

Vérifiez en priorité :

si vous utilisez bien une sk-... créée dans la console MoleAPI
s’il y a des espaces avant ou après
si la copie est incomplète
si vous avez par erreur utilisé la Key d’une autre plateforme

403 : l’interface est accessible, mais vous n’avez pas l’autorisation d’effectuer cette action

Cette erreur est le plus souvent liée à :

la Key actuelle n’a pas les permissions pour ce modèle
le groupe actuel ne prend pas en charge ce modèle
une liste blanche IP est configurée, mais l’IP source ne correspond pas
le quota ou les limites de la Key ont été atteints

404 : l’adresse est incorrecte

C’est l’un des problèmes les plus fréquents chez les débutants.

Vérifiez en priorité :

si la Base URL est bien définie sur https://api.moleapi.com/v1
si vous envoyez encore les requêtes vers api.openai.com
si vous avez renseigné par erreur le chemin complet de l’API comme Base URL

429 : vous êtes limité, ou le quota n’est plus suffisant

Lorsque vous voyez un 429, ne pensez pas uniquement à « trop de requêtes trop vite ». Vérifiez aussi en même temps :

si le solde est insuffisant
si la Key a une limite
si le niveau de concurrence est trop élevé
si les requêtes sont trop fréquentes sur une courte période

500 : erreur côté serveur

S’il s’agit d’un incident ponctuel, vous pouvez d’abord réessayer ; s’il est reproductible de manière stable, il est recommandé de conserver :

l’heure de la requête
le nom du modèle
les paramètres de la requête
le Request ID (si le client le fournit)

Cela accélérera considérablement le diagnostic ultérieur.

Un ordre de diagnostic très pratique

Si vous ne savez pas par où commencer, suivez cet ordre pour gagner du temps :

Vérifiez le code de statut
Vérifiez la Base URL
Vérifiez l’API Key
Vérifiez le nom du modèle
Vérifiez le groupe / les permissions / les limites
Vérifiez le solde et les logs

Règle empirique

Pour un 404, commencez généralement par l’adresse ; pour un 401, par la Key ; pour un 403, par les permissions ; pour un 429, vérifiez non seulement la fréquence, mais aussi le solde et les limites.