API key एरर गाइड

API key काम नहीं कर रही? 401, 402, 403 और 429 एरर ऐसे ठीक करें

AI API key काम क्यों बंद कर देती है: 401, 402, 403 और 429 का मतलब, ख़ाली बैलेंस पर कौन-सा प्रोवाइडर कौन-सा कोड देता है, और हर एरर का हल।

अपडेट
  • जब कोई AI API key "काम नहीं करती", तो एरर नंबर वजह बता देता है: 401 का मतलब key ही ग़लत है, 402 का मतलब आम तौर पर बैलेंस या क्रेडिट ख़त्म है, 403 का मतलब key को वह काम करने की इजाज़त नहीं है, और 429 का मतलब बहुत ज़्यादा रिक्वेस्ट या, कुछ प्रोवाइडरों पर, ख़ाली बैलेंस।
  • ख़ाली बैलेंस के लिए सभी प्रोवाइडर एक ही कोड नहीं देते। DeepSeek, OpenRouter, Mistral, Together, Fireworks और प्रीपेड बिलिंग वाला Gemini 402 देते हैं; OpenAI, Kimi और Z.ai 429 देते हैं; Alibaba Cloud का Qwen 403 देता है। सिर्फ़ नंबर नहीं, मैसेज भी पढ़ें।
  • बैलेंस वाले एरर इंतज़ार करने से नहीं जाते; रेट लिमिट आम तौर पर चली जाती है। नीचे की तालिका में हर प्रोवाइडर का आधिकारिक एरर पेज है, जिसे 18 नवंबर 2026 को जाँचा गया।
iPhone पर Oriveo: प्रोवाइडर स्क्रीन, जहाँ आपके जोड़े हुए प्रोवाइडर और इस महीने का खर्च दिखता है।

"API key काम नहीं कर रही" का असल मतलब क्या है?

API key वह गुप्त कोड है जो ऐप हर रिक्वेस्ट के साथ भेजता है, ताकि AI प्रोवाइडर जान सके कि रिक्वेस्ट आपकी है और पैसा किसके अकाउंट से कटना है। कुछ गड़बड़ होने पर प्रोवाइडर एक एरर लौटाता है: तीन अंकों का एक नंबर, जिसे HTTP status code कहते हैं, और साथ में एक छोटा मैसेज।

नंबर बताता है कि दिक़्क़त किस तरह की है; मैसेज उसका ब्योरा देता है। Oriveo आम एरर को आसान शीर्षकों में बदल देता है, जैसे "अमान्य API key" या "प्रोवाइडर कोटा समाप्त"; इनकी बात इस पेज पर आगे है।

झटपट गाइड: 401, 402, 403, 429 और 5xx

यहीं से शुरू करें। अपना नंबर ढूँढें, फिर नीचे उससे जुड़ा हिस्सा पढ़ें। यह सार 18 नवंबर 2026 तक OpenAI, Anthropic और दूसरे प्रोवाइडरों के एरर पेजों पर आधारित है।

झटपट गाइड: 401, 402, 403, 429 और 5xx
कोडआम तौर पर मतलबक्या इंतज़ार से ठीक होगा?क्या करें
401key ग़लत है: कोई अक्षर छूटा है, फ़ालतू स्पेस है, key मिटा दी गई है, या key किसी दूसरे प्रोवाइडर या रीजन की हैनहींkey दोबारा कॉपी करें या नई बनाएँ; प्रोवाइडर और रीजन जाँचें
402पेमेंट चाहिए: प्रीपेड बैलेंस या क्रेडिट ख़त्म हो गए, या बिलिंग में कोई दिक़्क़त हैनहींटॉप-अप करें, या प्रोवाइडर के बिलिंग पेज पर पेमेंट का तरीक़ा ठीक करें
403key चलती है पर इजाज़त नहीं है: देश या रीजन सपोर्टेड नहीं, उस मॉडल का एक्सेस नहीं, या कोई वेरिफ़िकेशन बाक़ी हैनहींसपोर्टेड रीजन, key की परमिशन और कोई बाक़ी वेरिफ़िकेशन जाँचें
404मॉडल का नाम या पता ग़लत हैनहींदूसरा मॉडल चुनें या पता जाँचें
429कम समय में बहुत ज़्यादा रिक्वेस्ट, या कुछ प्रोवाइडरों पर ख़ाली बैलेंस या खर्च की लिमिटअक्सर, अगर रेट लिमिट हैरुककर दोबारा कोशिश करें; मैसेज में quota, balance, credit या spend limit लिखा हो, तो टॉप-अप करें या लिमिट बढ़ाएँ
500–504, 529प्रोवाइडर की तरफ़ ख़राबी या भीड़आम तौर पर हाँबाद में कोशिश करें या मॉडल बदलें

insufficient balance या quota क्यों लिखा आता है?

ज़्यादातर प्रोवाइडरों पर API चलाने से पहले प्रीपेड क्रेडिट या चालू बिलिंग चाहिए, और हर प्रोवाइडर ख़ाली बैलेंस को अपने ढंग से बताता है। इनमें से किसी भी हालत में नई key से कुछ नहीं होगा; क्रेडिट डालने से होगा।

नीचे Oriveo के 15 बिल्ट-इन प्रोवाइडरों में से हर एक का वह कोड है, जो बैलेंस या क्रेडिट ख़त्म होने पर उसके दस्तावेज़ों में बताया गया है। "नहीं बताया" का मतलब है कि 18 नवंबर 2026 को जाँचे गए प्रोवाइडर के दस्तावेज़ों में इस हालत का HTTP कोड नहीं दिया गया।

insufficient balance या quota क्यों लिखा आता है?
प्रोवाइडरबैलेंस ख़त्म होने पर कोडमैसेज में क्या लिखा होता हैआधिकारिक पेज
OpenAI429credit_balance_exhausted (एरर का type अब भी insufficient_quota लिखा हो सकता है)developers.openai.com/api/docs/guides/error-codes
Anthropic (Claude)नहीं बताया"Your credit balance is too low to access the Anthropic API"; पेमेंट की दिक़्क़त पर 402 billing_error आता हैplatform.claude.com/docs/en/api/errors (कोड); platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (मैसेज)
Google Gemini402 (प्रीपेड बिलिंग)payment_required; 403 का मतलब Cloud Billing पर बकाया बैलेंस भी हो सकता हैaistudio.google.com/docs/api-errors
OpenRouter402आपके अकाउंट या API key में पर्याप्त क्रेडिट नहीं हैंopenrouter.ai/docs/api-reference/errors
DeepSeek402Insufficient Balanceapi-docs.deepseek.com/quick_start/error_codes
xAI (Grok)नहीं बतायाप्रीपेड क्रेडिट ख़त्म होते ही रिक्वेस्ट ठुकरा दी जाती हैंdocs.x.ai/console/billing
Mistral AI402Payment requireddocs.mistral.ai/resources/error-glossary
Groqदस्तावेज़ में नहींGroq इस्तेमाल के बाद बिल करता है; उसके एरर पेज पर बैलेंस का कोई एरर नहीं हैconsole.groq.com/docs/errors
Together AI402Payment Requireddocs.together.ai/docs/error-codes
Fireworks AI402Payment Requireddocs.fireworks.ai/guides/inference-error-codes
MiniMaxनहीं बताया (बिज़नेस कोड 1008)insufficient balanceplatform.minimax.io/docs/api-reference/errorcode
Z.ai (GLM)429 (कोड 1113)Insufficient balance or no resource package. Please recharge.docs.z.ai/api-reference/api-code
Qwen (Alibaba Cloud)403Arrearage या isv.OUT_OF_SERVICE (अकाउंट पर बकाया)alibabacloud.com/help/en/model-studio/error-code
Kimi (Moonshot AI)429exceeded_current_quota_errorplatform.kimi.ai/docs/api/errors
SiliconFlowदस्तावेज़ में नहींबैलेंस का कोई एरर सूची में नहींdocs.siliconflow.com/en/faqs/error-code

401: invalid API key या authentication failed

401 का मतलब है कि प्रोवाइडर key को पहचान नहीं रहा। आम मैसेज होते हैं "Incorrect API key provided" (OpenAI), "authentication_error" (Anthropic), "Authentication Fails" (DeepSeek) और "Invalid API key: this is not an OpenRouter API key" (OpenRouter)।

  • प्रोवाइडर की साइट से key दोबारा कॉपी करें, और देखें कि कोई अक्षर छूटा न हो और आगे-पीछे स्पेस न हो।
  • पक्का करें कि key उसी प्रोवाइडर की है जो आपने चुना है। OpenAI की key OpenRouter key की तरह नहीं चलेगी, और OpenRouter की key OpenAI पर नहीं।
  • Kimi, MiniMax और Qwen के अलग-अलग रीजनल प्लेटफ़ॉर्म हैं, और एक की key दूसरे पर नहीं चलती। Oriveo में "आधिकारिक समापन बिंदु" सिलेक्टर (iPhone पर "आधिकारिक अनुरोध URL") में उसी से मेल खाता रीजन चुनें।
  • अगर key मिटा दी गई है, रद्द हो गई है या एक्सपायर हो गई है, तो नई बनाएँ।

402: payment required या insufficient balance

402 पैसों से जुड़ा है: प्रीपेड बैलेंस ख़ाली है, या पेमेंट का तरीक़ा फ़ेल हो गया। प्रोवाइडर के बिलिंग पेज पर टॉप-अप करें या पेमेंट की जानकारी अपडेट करें, फिर दोबारा भेजें। इंतज़ार से कुछ नहीं होता।

Oriveo में यह "प्रोवाइडर कोटा समाप्त" के रूप में दिखता है: "प्रोवाइडर के अनुसार इस API key का कोटा या क्रेडिट समाप्त हो गया है। प्रोवाइडर के खाते में अपनी बिलिंग जाँचें या मॉडल बदलें।"

403: forbidden या permission denied

403 का मतलब है कि प्रोवाइडर ने key पहचान ली, पर रिक्वेस्ट की इजाज़त नहीं दे रहा। वजह प्रोवाइडर पर निर्भर करती है:

  • जिस देश में OpenAI का API सपोर्टेड नहीं है, वहाँ से इस्तेमाल करने पर OpenAI "Country, region, or territory not supported" लौटाता है। हर प्रोवाइडर सपोर्टेड देशों की अपनी सूची प्रकाशित करता है।
  • Gemini 403 तब लौटाता है जब किसी free-tier प्रोजेक्ट को वेरिफ़िकेशन चाहिए (FREE_TIER_VERIFICATION_REQUIRED), जब उससे जुड़े Cloud Billing अकाउंट पर बकाया है, या जब Google ने लीक बताई गई key को ब्लॉक कर दिया है।
  • key को उस रिसोर्स के इस्तेमाल की इजाज़त न हो, तो Anthropic permission_error लौटाता है; अपने ऑर्गनाइज़ेशन और वर्कस्पेस की सेटिंग देखें।
  • OpenRouter 403 तब लौटाता है जब रिक्वेस्ट परमिशन, मॉडरेशन, गार्डरेल या बजट लिमिट की वजह से रुक जाए।
  • SiliconFlow कुछ मॉडलों के लिए पहचान का वेरिफ़िकेशन माँगता है।
  • Qwen बकाया वाले अकाउंट के लिए 403 देता है, और AllocationQuota.FreeTierOnly के लिए भी, जब फ्री कोटा ख़त्म हो जाए और "Free Quota Only" सेटिंग चालू हो।

429: too many requests, rate limit या quota exceeded

ज़्यादातर मामलों में 429 का मतलब है कि आपने कम समय में बहुत ज़्यादा रिक्वेस्ट या टोकन भेज दिए। यह रेट लिमिट है, और कुछ दसियों सेकंड रुकने पर हट जाती है। जवाब में Retry-After का समय दिया हो, तो उतना रुकें।

कई प्रोवाइडर ख़ाली बैलेंस या खर्च की लिमिट के लिए भी 429 देते हैं, और वह इंतज़ार से ठीक नहीं होता: OpenAI (credit_balance_exhausted, या आपकी तय की हुई spend limit), Kimi (exceeded_current_quota_error), Z.ai (कोड 1113), और Anthropic, जब कोई ऑर्गनाइज़ेशन अपनी महीने की spend limit तक पहुँच जाए (enforced_spend_limit_reached); यह अगले महीने तक रहता है, जब तक आप ऊँचे टियर की माँग न करें।

फ्री टियर में लिमिट और तंग होती है। Gemini के फ्री टियर और OpenRouter के फ्री मॉडलों पर प्रति मिनट और प्रति दिन की लिमिट है।

Oriveo में रेट लिमिट वेब पर "दर सीमित" और iPhone व Android पर "प्रोवाइडर रेट लिमिट" के रूप में दिखती है। मैसेज में quota या credit का ज़िक्र हो, तो Oriveo इसकी जगह "प्रोवाइडर कोटा समाप्त" दिखाता है।

Oriveo के एरर मैसेज का क्या मतलब है?

Oriveo में आपको ये मैसेज दिख सकते हैं; हिंदी इंटरफ़ेस में इनके शब्द यही हैं:

Oriveo के एरर मैसेज का क्या मतलब है?
Oriveo में क्या दिखता हैमतलबक्या करें
सहेजा गया, लेकिन कुंजी अमान्य लगती है। आप इसे बाद में प्रोवाइडर सेटिंग्स में सत्यापित कर सकते हैं।Oriveo ने प्रोवाइडर सेव कर लिया, पर जाँच के दौरान प्रोवाइडर ने key ठुकरा दीkey दोबारा कॉपी करें और उस प्रोवाइडर की सेटिंग में अपडेट करें
अमान्य API keyप्रोवाइडर ने 401 या 403 लौटायाkey जाँचें या बदलें; 403 हो तो रीजन और परमिशन देखें
प्रोवाइडर कोटा समाप्तप्रोवाइडर कह रहा है कि इस key का क्रेडिट या कोटा ख़त्म हो गया (402, या quota वाला 429)प्रोवाइडर के यहाँ टॉप-अप करें, या कोई दूसरा मॉडल चुनें
दर सीमित (वेब) / प्रोवाइडर रेट लिमिट (iPhone, Android)अभी के लिए बहुत ज़्यादा रिक्वेस्ट (429)थोड़ा रुककर दोबारा कोशिश करें
निःशुल्क कोटा समाप्त (वेब, iPhone) / मुफ़्त कोटा पूरा हो गया (Android)आज का Oriveo Free कोटा पूरा हो गया; इसका आपकी अपनी key से कोई लेना-देना नहींअपनी API key जोड़ें, या 00:00 UTC पर रीसेट का इंतज़ार करें
Oriveo की प्रोवाइडर स्क्रीन, जिसमें OpenAI, Z.ai, Groq, Gemini और Anthropic जैसे जुड़े हुए प्रोवाइडर अपने खर्च के साथ दिख रहे हैं
किसी प्रोवाइडर की key जाँचने या बदलने के लिए इस सूची से उसे खोलें।

कस्टम एंडपॉइंट, रिले या गेटवे इस्तेमाल कर रहे हैं?

अगर आप कस्टम एंडपॉइंट से जुड़ते हैं, तो एरर उस सर्विस से भी आ सकता है और उसके पीछे के प्रोवाइडर से भी। जब Oriveo कहे "यह कनेक्शन अपने अपस्ट्रीम प्रोवाइडर तक नहीं पहुँच सका।", तो हो सकता है कि प्रोवाइडर के पास उस सर्विस का अपना अकाउंट अमान्य हो, उसके क्रेडिट ख़त्म हों या उस पर रेट लिमिट लगी हो। यह आपकी कॉन्फ़िगरेशन की ग़लती नहीं है; कोई दूसरा कनेक्शन चुनें या सर्विस चलाने वाले से संपर्क करें।

नई key बनाने से पहले ये जाँच लें

नई key से 401 ठीक होता है, और ज़्यादा कुछ नहीं। पहले यह सूची देख लें:

  • आपने सही प्रोवाइडर चुना है, और Kimi, MiniMax, Qwen, SiliconFlow और Z.ai के लिए सही रीजन भी।
  • आपने पूरी key कॉपी की है, बिना स्पेस के।
  • अकाउंट में क्रेडिट है, या बिलिंग का कोई चालू तरीक़ा जुड़ा है।
  • आपका देश या रीजन प्रोवाइडर की सपोर्टेड सूची में है।
  • आपका चुना मॉडल आपके अकाउंट या टियर पर उपलब्ध है।

ऐप से जुड़े आम सवाल

मेरी API key काम क्यों नहीं कर रही?
एरर नंबर देखें। 401 का मतलब है key ग़लत है, 402 का मतलब बैलेंस या क्रेडिट ख़त्म हो गए, 403 का मतलब रिक्वेस्ट की इजाज़त नहीं है (अक्सर रीजन या परमिशन की वजह से), और 429 का मतलब बहुत ज़्यादा रिक्वेस्ट या, कुछ प्रोवाइडरों पर, ख़ाली बैलेंस।
API key पर 401 एरर का क्या मतलब है?
प्रोवाइडर key को पहचान नहीं रहा। key बिना स्पेस के दोबारा कॉपी करें, जाँचें कि वह आपके चुने प्रोवाइडर और रीजन की है, या नई key बनाएँ।
402 Payment Required एरर क्या है?
आपका प्रीपेड बैलेंस या क्रेडिट ख़त्म हो गया है, या पेमेंट में कोई दिक़्क़त है। DeepSeek, OpenRouter, Mistral, Together, Fireworks और प्रीपेड बिलिंग वाला Gemini यही कोड देते हैं। प्रोवाइडर के बिलिंग पेज पर टॉप-अप करें; इंतज़ार से यह ठीक नहीं होगा।
429 एरर रेट लिमिट है या कोटा की दिक़्क़त?
दोनों में से कुछ भी हो सकता है। आम तौर पर यह रेट लिमिट होती है, जो थोड़ी देर में हट जाती है। पर OpenAI, Kimi और Z.ai बैलेंस ख़ाली होने पर भी 429 देते हैं, इसलिए मैसेज में quota, balance या credit लिखा हो, तो इंतज़ार की जगह क्रेडिट डालें।
मेरी OpenAI API key insufficient_quota क्यों दिखा रही है?
आपके OpenAI API अकाउंट में प्रीपेड क्रेडिट नहीं बचा। OpenAI कोड credit_balance_exhausted के साथ 429 लौटाता है, और एरर का type अब भी insufficient_quota लिखा हो सकता है। OpenAI की बिलिंग सेटिंग में क्रेडिट डालें; नई key से कुछ नहीं होगा।
सही कॉपी करने के बाद भी मेरी नई API key क्यों नहीं चल रही?
आम तौर पर इसलिए कि अकाउंट में अभी क्रेडिट नहीं है या बिलिंग सेट नहीं है, key किसी दूसरे रीजन की है, या आपके देश में वह API उपलब्ध नहीं है। दूसरी key बनाने से पहले ये बातें जाँच लें।

इनसे जुड़े आर्टिकल

ब्लॉग से

हर key के एरर आसान भाषा में समझें

वेब ऐप खोलें या iPhone या Android के लिए Oriveo डाउनलोड करें, 15 प्रोवाइडरों की key जोड़ें, और कोई रिक्वेस्ट फ़ेल हो तो उसकी साफ़ वजह जानें।

अभी API key नहीं है? Oriveo Free से बिना key के शुरू करें।