Une clé API est un badge numérique : une longue suite de caractères qui dit au service « c'est moi qui appelle, et c'est moi qui paie ». Celui qui la possède peut dépenser ton crédit. Elle se range donc comme un mot de passe, dans un endroit prévu pour ça, avec un plafond de dépenses.
C'est quoi, une clé API ?
Une API est l'entrée de service d'un logiciel, faite pour les programmes plutôt que pour les humains. Quand n8n, une application ou un agent veut parler à une IA, il envoie une requête à cette entrée et montre sa clé pour s'identifier. Sans clé, ou avec une clé fausse, le service répond par un code d'erreur, le plus souvent un 401.
Une clé ressemble à sk-or-v1-... chez OpenRouter, avec un préfixe différent selon le fournisseur. Chez OpenRouter, elle n'est plus affichée après la création : copie-la tout de suite dans l'endroit prévu.
Ton abonnement de chat donne-t-il accès à l'API ?
Non. L'abonnement (Claude Pro, ChatGPT Plus) paie l'accès à l'application de chat. L'API se facture à part, à l'usage. Anthropic l'écrit dans son aide : l'API de Claude est facturée séparément et passe par la console développeur. Pour ChatGPT, vérifie sur le site d'OpenAI : la logique est la même, avec un compte et une facturation distincts pour l'API.
| Abonnement de chat | Clé API | |
|---|---|---|
| Ce que tu paies | Un forfait pour l'application | Un usage mesuré, à l'avance ou à la fin du mois selon le fournisseur |
| Où tu l'utilises | Dans l'application | Dans n8n, un script, une application |
| Ce qui est facturé | Le forfait | Les textes envoyés et reçus (voir les tarifs du fournisseur, à vérifier sur son site) |
Où créer une clé ?
Chaque fournisseur a son tableau de bord. Voici les endroits à connaître, à vérifier le jour où tu t'y rends car les menus bougent.
| Fournisseur | Où créer la clé | Remarque |
|---|---|---|
| OpenRouter | openrouter.ai, rubrique Keys | Une seule clé donne accès à plusieurs modèles. Crédit payé à l'avance |
| Anthropic (Claude) | Console Claude, page des clés d'API | La documentation propose de choisir l'expiration de la clé et de configurer des plafonds de dépenses |
| OpenAI | platform.openai.com | Les clés s'envoient dans l'en-tête Authorization: Bearer ... |
| Google (Gemini) | aistudio.google.com | Une offre gratuite limitée existe, à vérifier |
Anthropic détaille la marche dans la vue d'ensemble de l'API : créer un compte Console, puis générer une clé sur la page dédiée. OpenAI précise dans sa référence d'authentification que la clé est un secret et qu'elle ne doit jamais se trouver dans du code côté navigateur ou application mobile.
Quelles sont les quatre règles pour protéger une clé ?
- Jamais dans un message, un document partagé, une capture d'écran ou un chat avec une IA. Même pour demander de l'aide.
- Toujours dans les identifiants (credentials) de n8n, jamais collée en clair dans un nœud. Quand tu exportes un workflow, les identifiants ne partent pas avec lui.
- Toujours avec un plafond de dépenses. Distingue le solde de ton compte (l'argent versé) et le plafond de la clé (le maximum que cette clé peut dépenser).
- Si elle fuite, révoque-la tout de suite dans le tableau de bord du fournisseur, puis crée-en une nouvelle. Effacer le message qui la contenait ne suffit pas, car quelqu'un a pu la copier.
Comment ranger une clé dans n8n ?
- Dans n8n, clique sur le bouton + en haut à gauche, puis sur New credential.
- Choisis Header Auth.
- Donne un nom clair à l'identifiant, par exemple « OpenRouter - ma clé ».
- Dans Name, écris
Authorization. - Dans Value, écris
Bearer, un espace, puis ta clé. - Enregistre. Dans le nœud HTTP Request, choisis Generic Credential Type, puis Header Auth, puis cet identifiant.
La clé n'apparaît plus jamais en clair dans tes workflows. Si tu ne sais pas encore ce qu'est un workflow, commence par n8n, c'est quoi.
Que faire si le nœud répond 401 ?
Un 401 veut dire « badge refusé » : la clé est absente, fausse ou révoquée. Vérifie d'abord ces trois points :
- le mot
Bearersuivi d'un espace est bien présent avant la clé ; - il n'y a pas d'espace en trop à la fin de la clé collée ;
- l'identifiant est bien choisi dans le nœud, et l'authentification n'est pas sur « None ».
Un 402 signale en général un crédit épuisé ou un plafond atteint : ton plafond a alors fait son travail. Regarde le solde du compte et la limite de la clé avant de relancer. Pour le tableau complet des codes, lis erreur 401 et 429 d'une API d'IA.
Quel plafond fixer pour apprendre ?
Un petit plafond suffit pour apprendre : le niveau 1 de la formation Agenkio prévoit environ 5 $ de crédit pour tous les exercices, dont un test de 20 demandes qui ne coûte que quelques centimes. Vérifie le montant minimum et les frais éventuels affichés au moment de payer chez ton fournisseur. Un plafond bas limite la casse si la clé fuite ou si un workflow boucle par erreur.
Questions fréquentes
Puis-je mettre ma clé API dans un chat avec une IA pour demander de l'aide ?
Non. Colle l'erreur ou la page de documentation, jamais la clé. Si tu l'as fait par réflexe, révoque-la et crée-en une nouvelle.
Une clé API est-elle gratuite ?
Créer une clé ne coûte généralement rien, mais utiliser l'API se paie à l'usage. Certains fournisseurs proposent une offre gratuite limitée, par exemple Google pour Gemini, à vérifier sur leur site.
Que se passe-t-il si quelqu'un trouve ma clé ?
Il peut faire des appels à tes frais, dans la limite du solde ou du plafond. C'est pourquoi il faut un plafond et révoquer la clé dès qu'un doute apparaît.
Dois-je changer de clé régulièrement ?
Une clé qui n'a jamais été exposée n'a pas à être changée par principe, mais certains fournisseurs te laissent choisir une date d'expiration à la création. Change-la dès qu'elle a pu être vue par quelqu'un d'autre.