Quand on code pour intégrer ChatGPT, Claude ou Gemini, ce qui rend le plus fou, ce n’est pas que le modèle ne soit pas assez intelligent, c’est qu’il t’ignore carrément : 401, 403, 429 qui se relaient. La procédure ci-dessous est celle que j’utilise le plus souvent ; elle ramène en gros le “l’API ne marche pas” du domaine du mystique à la réalité.
Premier type d’erreur : 401 — clé invalide ou signature incorrecte
Si tu vois invalid_api_key, Unauthorized, ne remets pas ta vie en question : dans 80% des cas, c’est un espace en trop en copiant, un préfixe manquant, ou une clé de l’environnement de test utilisée en production.
- Vérifie que la clé provient de la bonne plateforme : OpenAI, Anthropic et Google ne sont pas interchangeables
- Contrôle les en-têtes de requête : le format Bearer est-il correct ?
- Teste avec une requête minimale pour valider, ne commence pas en envoyant une tonne de paramètres
Deuxième type d’erreur : 429 — limitation de débit (rate limit) ou quota épuisé
Une 429 ressemble à un problème réseau, mais en réalité c’est plutôt : “tu en abuses”.
- Limite la concurrence et fais des retries avec backoff exponentiel
- Vérifie la facturation et les quotas ; sur Gemini et Claude, ne te trompe pas de projet/organisation
- Si le texte est long, découpe-le ; pour les prompts, applique le principe KISS : plus simple est souvent plus stable
Troisième type d’erreur : 403 — blocage par région ou par contrôle de risque
La 403, souvent, ce n’est pas que tu n’as pas les droits : c’est la plateforme qui te juge “suspect”. Réseau interne d’entreprise, IP de datacenter, changements fréquents de nœud… tout ça peut déclencher.


