Quand on code pour connecter ChatGPT, Claude ou Gemini, le plus pénible, ce n’est pas la logique, c’est qu’un beau jour ça te sort une erreur de clé API, 401, 403. Tu as pourtant fait un copier-coller, mais ça ne veut rien savoir, au point de vouloir tremper le clavier dans le thé. J’ai résumé les pièges sur lesquels je suis tombé en une méthode de vérification universelle, qui couvre la plupart des cas (beaucoup de docs de plugins classent aussi ça dans « erreur de clé API / problème réseau »).
1 D’abord, vérifie que tu n’utilises pas le mot de passe du compte de chat
Une clé API n’est pas un mot de passe de connexion, ni une session côté web. OpenAI, Anthropic et Google ont chacun leur console : la clé doit être créée sur la plateforme correspondante ; n’essaie pas de « forcer » avec un compte ChatGPT Plus.
2 La clé a l’air identique, mais il y a des pièges de copie fréquents
Le plus courant : un espace ou un retour à la ligne en trop à la fin, ou bien un collage dans une config avec des guillemets. Je te conseille de coller la clé dans un éditeur en texte brut pour vérifier la longueur, puis de la recopier. Au passage, vérifie si le nom de variable d’environnement n’est pas mal écrit (par ex. OPENAI_API_KEY avec une lettre manquante).
3 Les autorisations et le projet ne sont pas correctement activés
Avec Gemini, il arrive souvent que l’API soit activée, mais que le projet ne soit pas lié à la facturation ou que le service correspondant ne soit pas activé ; avec Claude, un refus d’accès peut aussi venir des droits du compte ou des politiques régionales. En cas de 403, ne t’acharne pas sur « la clé est mauvaise » : souvent, c’est plutôt « tu n’as pas l’autorisation d’utiliser ça ».
