Clé API qui ne fonctionne pas ? Corriger les erreurs 401, 402, 403 et 429
Pourquoi une clé API d’IA cesse de fonctionner : le sens des erreurs 401, 402, 403 et 429, le code du solde épuisé selon le fournisseur et comment y remédier.
- Quand une clé API d’IA « ne fonctionne pas », le numéro d’erreur vous dit pourquoi : 401 signifie que la clé elle-même est incorrecte, 402 indique le plus souvent que votre solde ou vos crédits sont épuisés, 403 que la clé n’est pas autorisée à effectuer cette opération, et 429 qu’il y a trop de requêtes ou, chez certains fournisseurs, que le solde est vide.
- Les fournisseurs n’utilisent pas tous le même code pour un solde épuisé. DeepSeek, OpenRouter, Mistral, Together, Fireworks et la facturation prépayée de Gemini renvoient 402 ; OpenAI, Kimi et Z.ai renvoient 429 ; Qwen, d’Alibaba Cloud, renvoie 403. Lisez le message, pas seulement le numéro.
- Les erreurs de solde ne disparaissent pas en attendant ; les limites de débit, en général, si. Le tableau ci-dessous renvoie à la page d’erreurs officielle de chaque fournisseur, vérifiée le 18 novembre 2026.

Que veut vraiment dire « clé API qui ne fonctionne pas » ?
Une clé API est le code secret qu’une app envoie avec chaque requête, pour que le fournisseur d’IA sache que c’est vous et quel compte débiter. Quand quelque chose coince, le fournisseur répond par une erreur : un nombre à trois chiffres appelé code de statut HTTP, accompagné d’un court message.
Le nombre indique le type de problème ; le message donne le détail. Oriveo traduit les plus courants en titres clairs, comme « Clé API invalide » ou « Quota du fournisseur atteint », expliqués plus bas sur cette page.
Guide express : 401, 402, 403, 429 et 5xx
Commencez ici. Repérez votre numéro, puis lisez la section correspondante plus bas. Ce résumé suit les pages d’erreurs d’OpenAI, d’Anthropic et d’autres fournisseurs au 18 novembre 2026.
| Code | Signification habituelle | Attendre suffit-il ? | Que faire |
|---|---|---|---|
| 401 | La clé est incorrecte : un caractère manquant, un espace en trop, une clé supprimée, ou une clé d’un autre fournisseur ou d’une autre région | Non | Recopiez la clé ou créez-en une nouvelle ; vérifiez le fournisseur et la région |
| 402 | Paiement requis : votre solde prépayé ou vos crédits sont épuisés, ou il y a un problème de facturation | Non | Rechargez, ou corrigez le moyen de paiement sur la page de facturation du fournisseur |
| 403 | La clé fonctionne mais n’est pas autorisée : pays ou région non pris en charge, pas d’accès à ce modèle, ou une étape de vérification | Non | Vérifiez les régions prises en charge, les permissions de la clé et toute vérification demandée |
| 404 | Le nom du modèle ou l’adresse est incorrect | Non | Choisissez un autre modèle ou vérifiez l’adresse |
| 429 | Trop de requêtes en peu de temps ou, chez certains fournisseurs, un solde vide ou une limite de dépense | Souvent, s’il s’agit d’une limite de débit | Patientez puis réessayez ; si le message parle de quota, de solde, de crédit ou de limite de dépense, rechargez ou relevez la limite |
| 500–504, 529 | Une panne ou une surcharge du côté du fournisseur | En général | Réessayez plus tard ou changez de modèle |
Pourquoi le message parle-t-il de solde ou de quota insuffisant ?
La plupart des fournisseurs exigent du crédit prépayé ou un moyen de paiement actif avant que l’API fonctionne, et chacun signale un solde vide à sa manière. Une nouvelle clé ne corrige aucun de ces cas ; ajouter du crédit, si.
Voici le code que chacun des 15 fournisseurs intégrés à Oriveo documente quand votre solde ou votre crédit est épuisé. « Non précisé » signifie que la documentation du fournisseur, consultée le 18 novembre 2026, ne donne pas de code HTTP pour ce cas.
| Fournisseur | Code quand le solde est épuisé | Ce que dit le message | Page officielle |
|---|---|---|---|
| OpenAI | 429 | credit_balance_exhausted (le type d’erreur peut encore indiquer insufficient_quota) | developers.openai.com/api/docs/guides/error-codes |
| Anthropic (Claude) | Non précisé | « Your credit balance is too low to access the Anthropic API » ; les problèmes de paiement renvoient 402 billing_error | platform.claude.com/docs/en/api/errors (codes) ; platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (message) |
| Google Gemini | 402 (facturation prépayée) | payment_required ; un 403 peut aussi signaler un solde Cloud Billing impayé | aistudio.google.com/docs/api-errors |
| OpenRouter | 402 | Crédits insuffisants sur votre compte ou votre clé API | openrouter.ai/docs/api-reference/errors |
| DeepSeek | 402 | Insufficient Balance | api-docs.deepseek.com/quick_start/error_codes |
| xAI (Grok) | Non précisé | Les requêtes sont refusées une fois les crédits prépayés épuisés | docs.x.ai/console/billing |
| Mistral AI | 402 | Payment required | docs.mistral.ai/resources/error-glossary |
| Groq | Non documenté | Groq facture après usage ; sa page d’erreurs ne mentionne aucune erreur de solde | console.groq.com/docs/errors |
| Together AI | 402 | Payment Required | docs.together.ai/docs/error-codes |
| Fireworks AI | 402 | Payment Required | docs.fireworks.ai/guides/inference-error-codes |
| MiniMax | Non précisé (code métier 1008) | insufficient balance | platform.minimax.io/docs/api-reference/errorcode |
| Z.ai (GLM) | 429 (code 1113) | Insufficient balance or no resource package. Please recharge. | docs.z.ai/api-reference/api-code |
| Qwen (Alibaba Cloud) | 403 | Arrearage ou isv.OUT_OF_SERVICE (compte en défaut de paiement) | alibabacloud.com/help/en/model-studio/error-code |
| Kimi (Moonshot AI) | 429 | exceeded_current_quota_error | platform.kimi.ai/docs/api/errors |
| SiliconFlow | Non documenté | Aucune erreur de solde répertoriée | docs.siliconflow.com/en/faqs/error-code |
401 : clé API invalide ou échec d’authentification
Un 401 signifie que le fournisseur ne reconnaît pas la clé. Messages typiques : « Incorrect API key provided » (OpenAI), « authentication_error » (Anthropic), « Authentication Fails » (DeepSeek) et « Invalid API key: this is not an OpenRouter API key » (OpenRouter).
- Recopiez la clé depuis le site du fournisseur, et vérifiez qu’il ne manque aucun caractère et qu’il n’y a pas d’espace au début ni à la fin.
- Assurez-vous que la clé appartient bien au fournisseur choisi. Une clé OpenAI ne fonctionne pas comme clé OpenRouter, et inversement.
- Kimi, MiniMax et Qwen ont des plateformes régionales distinctes, et une clé de l’une ne fonctionne pas sur une autre. Dans Oriveo, choisissez la région correspondante dans le sélecteur « Endpoint officiel » (« URL de requête officielle » sur iPhone).
- Si la clé a été supprimée, révoquée ou a expiré, créez-en une nouvelle.
402 : paiement requis ou solde insuffisant
Un 402 est une question d’argent : le solde prépayé est vide, ou le moyen de paiement a échoué. Rechargez ou mettez à jour vos informations de paiement sur la page de facturation du fournisseur, puis renvoyez le message. Attendre n’y change rien.
Dans Oriveo, cela s’affiche sous la forme « Quota du fournisseur atteint » : « Le fournisseur signale que le quota ou le crédit de cette clé API est épuisé. Vérifiez votre facturation chez le fournisseur ou changez de modèle. »
403 : accès interdit ou permission refusée
Un 403 signifie que le fournisseur a reconnu la clé mais refuse la requête. La raison dépend du fournisseur :
- OpenAI renvoie « Country, region, or territory not supported » quand l’API est utilisée depuis un pays qu’il ne prend pas en charge. Chaque fournisseur publie sa liste de pays pris en charge.
- Gemini renvoie 403 quand un projet du niveau gratuit doit être vérifié (FREE_TIER_VERIFICATION_REQUIRED), quand le compte Cloud Billing associé a un solde impayé, ou quand Google a bloqué une clé signalée comme divulguée.
- Anthropic renvoie permission_error quand la clé ne peut pas utiliser la ressource ; vérifiez les réglages de votre organisation et de votre espace de travail (workspace).
- OpenRouter renvoie 403 quand une requête est bloquée par les permissions, la modération, un garde-fou ou une limite de budget.
- SiliconFlow exige une vérification d’identité pour certains modèles.
- Qwen utilise 403 pour un compte en défaut de paiement, ainsi que pour AllocationQuota.FreeTierOnly quand le quota gratuit est épuisé et que le réglage « Free Quota Only » est activé.
429 : trop de requêtes, limite de débit ou quota dépassé
La plupart du temps, 429 signifie que vous avez envoyé trop de requêtes ou de tokens en peu de temps. C’est une limite de débit (rate limit), et elle se lève si vous patientez quelques dizaines de secondes. Si la réponse indique un délai Retry-After, attendez ce délai.
Plusieurs fournisseurs utilisent aussi 429 pour un solde vide ou une limite de dépense, et là, attendre ne sert à rien : OpenAI (credit_balance_exhausted, ou une limite de dépense que vous avez fixée), Kimi (exceeded_current_quota_error), Z.ai (code 1113), et Anthropic quand une organisation atteint sa limite de dépense mensuelle (enforced_spend_limit_reached), qui reste en place jusqu’au mois suivant, sauf si vous demandez un palier supérieur.
Les offres gratuites sont plus strictes. Le niveau gratuit de Gemini et les modèles gratuits d’OpenRouter ont des limites par minute et par jour.
Dans Oriveo, une limite de débit s’affiche sous la forme « Limite de débit » sur le web ou « Limite de débit du fournisseur atteinte » sur iPhone et Android. Si le message parle de quota ou de crédit, Oriveo affiche plutôt « Quota du fournisseur atteint ».
Que signifient les messages d’erreur d’Oriveo ?
Voici les messages que vous pouvez voir dans Oriveo, tels qu’ils s’affichent en français :
| Ce qu’affiche Oriveo | Signification | Que faire |
|---|---|---|
| Enregistré, mais la clé semble invalide. Vous pouvez la vérifier plus tard dans les paramètres du fournisseur. | Oriveo a enregistré le fournisseur, mais celui-ci a refusé la clé lors de la vérification | Recopiez la clé et mettez-la à jour dans les paramètres de ce fournisseur |
| Clé API invalide | Le fournisseur a renvoyé 401 ou 403 | Vérifiez ou remplacez la clé ; pour un 403, vérifiez la région et les permissions |
| Quota du fournisseur atteint | Le fournisseur indique que le crédit ou le quota de cette clé est épuisé (402, ou 429 mentionnant un quota) | Rechargez chez le fournisseur, ou passez à un autre modèle |
| Limite de débit (web) / Limite de débit du fournisseur atteinte (iPhone et Android) | Trop de requêtes pour le moment (429) | Patientez un instant et réessayez |
| Quota gratuit atteint (« Quota Free atteint » sur Android) | Le quota Oriveo Free du jour est épuisé ; cela n’a rien à voir avec votre propre clé | Ajoutez votre propre clé API, ou attendez la réinitialisation à 00:00 UTC |

Vous passez par un endpoint personnalisé, un relais ou une passerelle ?
Si vous vous connectez via un endpoint personnalisé, l’erreur peut venir de ce service ou du fournisseur qui se trouve derrière. Quand Oriveo affiche « Cette connexion n’a pas pu joindre son fournisseur en amont », c’est peut-être le compte du service auprès du fournisseur qui est invalide, à court de crédits ou limité en débit. Votre configuration n’est pas en cause : passez à une autre connexion ou contactez la personne qui gère le service.
À vérifier avant de créer une nouvelle clé
Une nouvelle clé corrige un 401, et pas grand-chose d’autre. Passez d’abord cette liste en revue :
- Vous avez choisi le bon fournisseur et, pour Kimi, MiniMax, Qwen, SiliconFlow et Z.ai, la bonne région.
- Vous avez copié la clé entière, sans espace.
- Le compte dispose de crédit, ou d’un moyen de paiement actif.
- Votre pays ou votre région figure dans la liste des pays pris en charge par le fournisseur.
- Le modèle choisi est disponible pour votre compte ou votre palier.
Questions fréquentes sur l’app
Pourquoi ma clé API ne fonctionne-t-elle pas ?
Que signifie une erreur 401 pour une clé API ?
Qu’est-ce que l’erreur 402 Payment Required ?
Une erreur 429, c’est une limite de débit ou un problème de quota ?
Pourquoi ma clé API OpenAI affiche-t-elle insufficient_quota ?
Pourquoi ma nouvelle clé API ne marche-t-elle pas alors que je l’ai bien copiée ?
À lire aussi
Sur le blog
Des erreurs expliquées clairement, pour chaque clé
Ouvrez l’app web ou téléchargez Oriveo pour iPhone ou Android, ajoutez des clés de 15 fournisseurs et obtenez une raison claire quand une requête échoue.
Vous n’avez pas encore de clé API ? Commencez avec Oriveo Free.