Dépannage des clés API

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.

Mis à jour le
  • 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.
Oriveo sur iPhone : l’écran des fournisseurs, avec les fournisseurs que vous avez connectés et la dépense du mois.

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.

Guide express : 401, 402, 403, 429 et 5xx
CodeSignification habituelleAttendre suffit-il ?Que faire
401La 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égionNonRecopiez la clé ou créez-en une nouvelle ; vérifiez le fournisseur et la région
402Paiement requis : votre solde prépayé ou vos crédits sont épuisés, ou il y a un problème de facturationNonRechargez, ou corrigez le moyen de paiement sur la page de facturation du fournisseur
403La 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érificationNonVérifiez les régions prises en charge, les permissions de la clé et toute vérification demandée
404Le nom du modèle ou l’adresse est incorrectNonChoisissez un autre modèle ou vérifiez l’adresse
429Trop de requêtes en peu de temps ou, chez certains fournisseurs, un solde vide ou une limite de dépenseSouvent, s’il s’agit d’une limite de débitPatientez 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, 529Une panne ou une surcharge du côté du fournisseurEn généralRé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.

Pourquoi le message parle-t-il de solde ou de quota insuffisant ?
FournisseurCode quand le solde est épuiséCe que dit le messagePage officielle
OpenAI429credit_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_errorplatform.claude.com/docs/en/api/errors (codes) ; platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (message)
Google Gemini402 (facturation prépayée)payment_required ; un 403 peut aussi signaler un solde Cloud Billing impayéaistudio.google.com/docs/api-errors
OpenRouter402Crédits insuffisants sur votre compte ou votre clé APIopenrouter.ai/docs/api-reference/errors
DeepSeek402Insufficient Balanceapi-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ésdocs.x.ai/console/billing
Mistral AI402Payment requireddocs.mistral.ai/resources/error-glossary
GroqNon documentéGroq facture après usage ; sa page d’erreurs ne mentionne aucune erreur de soldeconsole.groq.com/docs/errors
Together AI402Payment Requireddocs.together.ai/docs/error-codes
Fireworks AI402Payment Requireddocs.fireworks.ai/guides/inference-error-codes
MiniMaxNon précisé (code métier 1008)insufficient balanceplatform.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)403Arrearage ou isv.OUT_OF_SERVICE (compte en défaut de paiement)alibabacloud.com/help/en/model-studio/error-code
Kimi (Moonshot AI)429exceeded_current_quota_errorplatform.kimi.ai/docs/api/errors
SiliconFlowNon documentéAucune erreur de solde répertoriéedocs.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 :

Que signifient les messages d’erreur d’Oriveo ?
Ce qu’affiche OriveoSignificationQue 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érificationRecopiez la clé et mettez-la à jour dans les paramètres de ce fournisseur
Clé API invalideLe fournisseur a renvoyé 401 ou 403Vérifiez ou remplacez la clé ; pour un 403, vérifiez la région et les permissions
Quota du fournisseur atteintLe 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
Écran Fournisseurs d’Oriveo listant des fournisseurs connectés comme OpenAI, Z.ai, Groq, Gemini et Anthropic, chacun avec ses dépenses
Ouvrez un fournisseur depuis cette liste pour vérifier ou remplacer sa clé.

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 ?
Regardez le numéro d’erreur. 401 : la clé est incorrecte ; 402 : votre solde ou vos crédits sont épuisés ; 403 : la requête n’est pas autorisée (souvent une question de région ou de permissions) ; 429 : trop de requêtes ou, chez certains fournisseurs, un solde vide.
Que signifie une erreur 401 pour une clé API ?
Le fournisseur ne reconnaît pas la clé. Recopiez-la sans espace, vérifiez qu’elle correspond au fournisseur et à la région choisis, ou créez-en une nouvelle.
Qu’est-ce que l’erreur 402 Payment Required ?
Votre solde prépayé ou vos crédits sont épuisés, ou il y a un problème de paiement. DeepSeek, OpenRouter, Mistral, Together, Fireworks et la facturation prépayée de Gemini l’utilisent. Rechargez sur la page de facturation du fournisseur ; attendre ne réglera rien.
Une erreur 429, c’est une limite de débit ou un problème de quota ?
Les deux sont possibles. Le plus souvent, c’est une limite de débit qui se lève après une courte attente. Mais OpenAI, Kimi et Z.ai renvoient aussi 429 quand votre solde est vide : si le message parle de quota, de solde ou de crédit, ajoutez du crédit au lieu d’attendre.
Pourquoi ma clé API OpenAI affiche-t-elle insufficient_quota ?
Votre compte API OpenAI n’a plus de crédit prépayé. OpenAI renvoie 429 avec le code credit_balance_exhausted, et le type d’erreur peut encore indiquer insufficient_quota. Ajoutez du crédit dans les réglages de facturation d’OpenAI ; une nouvelle clé n’y changera rien.
Pourquoi ma nouvelle clé API ne marche-t-elle pas alors que je l’ai bien copiée ?
En général parce que le compte n’a pas encore de crédit ou que la facturation n’est pas configurée, que la clé appartient à une autre région, ou que l’API n’est pas proposée dans votre pays. Vérifiez ces points avant de créer une autre clé.

À 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.