Ce qui fait le plus monter la tension, ce n’est pas que le modèle ne sache pas écrire, c’est que tu es sur le point de t’y mettre et que la console te balance : API key invalid, 401, network error. Moi, le piège dans lequel je tombe le plus souvent, c’est : la clé est bonne, le problème vient de la « configuration autour ». Cette checklist est organisée dans l’ordre que j’utilise le plus : ChatGPT, Claude, Gemini.
Vérifie d’abord que tu utilises la bonne clé et le bon projet
Beaucoup de gens copient une ancienne clé, une clé de test, ou bien changent de projet dans la console sans s’en rendre compte. Je te conseille de créer directement une nouvelle clé dans le back-office du fournisseur et de la remplacer tout de suite une fois, au lieu de t’acharner avec l’ancien environnement.
Sans droits et sans facturation activés, c’est comme si tu n’avais pas de clé
Un 401/403 ne signifie pas forcément que la clé est mauvaise ; le plus courant, c’est la facturation non activée, un périmètre d’autorisations insuffisant, ou des restrictions d’organisation/projet. Avec Claude et Gemini, ce genre de situation « ça a l’air de marcher », mais dès que tu passes par l’API ça plante, est particulièrement fréquent — ne me demande pas comment je le sais.
Variables d’environnement et espaces : les tueurs silencieux
Un espace en trop dans le .env, un saut de ligne mal géré, ou une plateforme de déploiement qui n’injecte pas les variables : tout ça peut se transformer en « clé invalide ». Afficher la longueur de la clé et faire un trim au début/à la fin, c’est souvent plus efficace que de fixer l’erreur pendant une demi-heure.
