Une erreur 401 signifie que le service refuse ta clé API : elle est absente, mal écrite, désactivée ou révoquée. Une erreur 429 signifie que tu as atteint une limite : trop de requêtes en peu de temps, ou parfois un plafond de dépenses. Dans les deux cas, le problème vient de ta demande ou de ton compte, pas du serveur.
Que veut dire un code d'erreur d'API ?
Un code d'erreur est la façon dont l'API te répond quand elle ne peut pas traiter ta demande. Pense à un guichet : si ton formulaire est mal rempli ou si ton badge est invalide, on te rend un code au lieu de la réponse. La règle de base : 4xx, c'est ta demande ; 5xx, c'est leur serveur.
| Code | Ce que ça veut dire | Ce que tu fais |
|---|---|---|
| 200 | Requête acceptée (regarde quand même le contenu) | Rien |
| 400 | Demande mal remplie (JSON invalide, champ manquant) | Relis le corps de la requête et la documentation |
| 401 | Clé refusée : absente, fausse ou révoquée | Vérifie la clé et la façon de l'envoyer |
| 402 | Crédit épuisé ou plafond de la clé atteint (OpenRouter) | Regarde ton solde et la limite de la clé |
| 403 | Clé valide mais accès interdit | Vérifie les permissions de la clé |
| 404 | Mauvaise adresse | Vérifie l'URL |
| 429 | Limite atteinte | Lis le message, attends ou ajuste ton budget |
| 500, 502, 503 | Problème côté serveur | Réessaie plus tard, regarde la page de statut |
Un piège à connaître : certaines API peuvent renvoyer un 200 et glisser une erreur dans le contenu de la réponse. OpenRouter le précise dans sa documentation des erreurs : le corps peut contenir un objet error sans choices alors que le statut est 200. Regarde donc toujours le contenu, pas seulement le code.
Pourquoi j'ai une erreur 401 ?
Tu as une erreur 401 parce que le service ne reconnaît pas ta clé. Chez les trois fournisseurs d'IA les plus courants, la cause est la même :
- OpenAI : clé incorrecte ou organisation non reconnue (voir les codes d'erreur d'OpenAI).
- Anthropic : clé mal formée, révoquée ou expirée, d'après la page des erreurs de la documentation Claude.
- OpenRouter : clé désactivée ou invalide.
Comment corriger une erreur 401 dans n8n ?
Procède dans cet ordre :
- Ouvre le nœud HTTP Request en erreur et lis le message complet. Il dit souvent clairement ce qui ne va pas.
- Vérifie l'identifiant (credential) choisi dans le nœud. Si tu as créé un identifiant de type Header Auth, le champ Name doit valoir
Authorizationet le champ Value doit commencer par le motBearersuivi d'un espace, puis ta clé. Oublier « Bearer » ou l'espace est la cause la plus fréquente. - Vérifie que la clé est encore active dans le tableau de bord du fournisseur. Une clé révoquée, supprimée ou limitée ne fonctionne plus.
- Recopie la clé sans espace ni retour à la ligne en trop.
- Relance avec Execute step (le bouton du nœud) pour tester ce seul appel.
Pour vérifier que tu sais reconnaître un 401, fais l'expérience : dans le nœud, mets Authentication sur None et lance Execute step. Tu dois obtenir un 401. Remets ensuite ton identifiant.
Règle de sécurité : ne colle jamais ta clé dans un message, une capture d'écran ou un chat, même pour demander de l'aide. Range-la dans les identifiants de n8n. Si elle fuite, révoque-la tout de suite chez le fournisseur et crées-en une nouvelle.
Pourquoi j'ai une erreur 429 ?
Une erreur 429 a deux familles de causes, et il faut les distinguer parce que la réponse est opposée.
| Cause | Exemple de message | Ce qui marche |
|---|---|---|
| Débit : trop de requêtes trop vite | « Rate limit reached for requests » | Attendre, puis réessayer. Respecter l'en-tête Retry-After quand il existe |
| Budget : plafond de dépense ou crédit atteint | Crédit épuisé, limite de dépense atteinte | Recharger ou relever la limite. Réessayer ne sert à rien |
OpenAI est explicite sur ce point : réessayer une erreur de facturation ou de quota ne restaure pas l'accès, il faut d'abord modifier les crédits ou les limites. Anthropic décrit la même logique : un 429 dû au plafond de dépense mensuel n'a pas d'en-tête retry-after et continue d'échouer tant que l'accès n'est pas rétabli.
Chez OpenRouter, un crédit épuisé ou un plafond de clé atteint donne plutôt un 402, et le 429 correspond à une limitation de débit. Compare toujours avec la documentation de ton fournisseur, car les codes peuvent évoluer.
Un 429 peut aussi venir d'une API publique
Les API publiques sans clé limitent parfois le nombre d'appels par adresse IP. Sur n8n Cloud, plusieurs utilisateurs partagent les mêmes adresses : tu peux donc recevoir un 429 sans avoir rien fait de mal, avec l'API météo Open-Meteo par exemple. Attends quelques minutes, ou le lendemain si le message parle d'une limite quotidienne.
Comment réessayer automatiquement dans n8n ?
Sur un nœud qui appelle l'IA, ouvre l'onglet Settings du nœud et règle :
- Retry On Fail : activé ;
- Max. Tries : 3 ;
- Wait Between Tries : 5000 ms.
Place ces reprises uniquement avant toute écriture ou notification. Le classement par une IA est sans danger à refaire. Une écriture dans Google Sheets, elle, a peut-être réussi alors que la réponse s'est perdue : la relancer créerait un doublon. Si un nœud échoue après une action, vérifie ce qui a été fait avant de rejouer.
Et si l'erreur arrive quand je dors ?
Les reprises règlent les pannes passagères, pas les autres. Pour savoir qu'un workflow a échoué sans ouvrir n8n, mets en place une alerte : voir être prévenu quand un workflow n8n casse. Et pour comprendre comment l'API reçoit ton message, le guide sur la lecture d'un JSON dans n8n complète celui-ci. Le module sur les API du niveau 1 fait pratiquer ces erreurs volontairement, en cassant une URL ou en retirant la clé.
Questions fréquentes
Mon abonnement ChatGPT Plus ou Claude Pro donne-t-il accès à l'API ?
Non. L'abonnement de chat et l'API sont deux produits séparés. L'API se paie à part, à l'usage, avec une clé que tu crées chez le fournisseur. Vérifie les tarifs actuels sur le site du fournisseur.
Puis-je réessayer un 401 ?
Non, ça ne sert à rien : la clé sera refusée de la même façon. Corrige d'abord la clé ou la façon de l'envoyer.
Un 429 veut-il dire que je suis bloqué définitivement ?
Non. Pour une limite de débit, la restriction est temporaire. Pour une limite de budget, elle dure jusqu'à ce que tu relèves ton plafond ou que ton crédit soit rechargé.
Quelle est la différence entre le solde du compte et le plafond de la clé ?
Le solde est l'argent que tu as versé. Le plafond d'une clé est le maximum que cette clé peut dépenser. Une clé peut atteindre son plafond alors que ton compte a encore du crédit, ce qui provoque une erreur : regarde les deux.