Tu as peut-être déjà vécu ce moment de frustration : ChatGPT ou Claude branché sur un client tiers, et dès la première phrase ça renvoie 401/403 ; côté Gemini, tu as pourtant bien copié la Key, mais ça dit quand même qu’elle est invalide. Pas de panique : dans 80% des cas, ce n’est pas “tu n’y as pas droit”, c’est un petit détail qui te met des bâtons dans les roues.
1 Identifie clairement de quel type d’erreur il s’agit
401 = le plus souvent Key mal saisie / non envoyée ; 403 = plutôt permissions, région ou projet non activé ; 429 = quota atteint ou limitation de débit. Commence par faire une capture du code d’erreur : ça te fera gagner la moitié du temps pendant le diagnostic.
2 Problème de Key elle-même : le plus courant et le plus absurde
- Un espace ou un saut de ligne en trop lors de la copie (surtout depuis un document)
- Confondre une “Key visible” avec la “vraie Key” (certaines plateformes ne l’affichent qu’une seule fois)
- Mauvais environnement : une Key de test utilisée en production
Petite remarque : beaucoup d’“erreurs de clé API” ne sont en réalité qu’un espace invisible — impossible à voir à l’œil nu, mais le programme, lui, ne te fera aucun cadeau.
3 Permissions et interrupteurs non activés : tu crois que c’est activé, mais ça ne l’est pas
Sur Gemini, le cas classique, c’est l’API non activée dans le projet correspondant ; pour les API liées à ChatGPT, il faut aussi vérifier le projet et l’état de la facturation. Pour Claude, si tu passes par une couche outil, pense à vérifier si l’outil a bien répercuté les permissions.
4 Proxy et région : des faux échecs
Si la même Key ne marche pas sur le réseau de l’entreprise mais fonctionne via le partage de connexion du téléphone, c’est presque toujours un problème de chemin réseau. Élimine proxy, DNS, passerelle d’entreprise, etc., avant d’accuser le produit.
