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 को जाँचा गया।

"API key काम नहीं कर रही" का असल मतलब क्या है?
API key वह गुप्त कोड है जो ऐप हर रिक्वेस्ट के साथ भेजता है, ताकि AI प्रोवाइडर जान सके कि रिक्वेस्ट आपकी है और पैसा किसके अकाउंट से कटना है। कुछ गड़बड़ होने पर प्रोवाइडर एक एरर लौटाता है: तीन अंकों का एक नंबर, जिसे HTTP status code कहते हैं, और साथ में एक छोटा मैसेज।
नंबर बताता है कि दिक़्क़त किस तरह की है; मैसेज उसका ब्योरा देता है। Oriveo आम एरर को आसान शीर्षकों में बदल देता है, जैसे "अमान्य API key" या "प्रोवाइडर कोटा समाप्त"; इनकी बात इस पेज पर आगे है।
झटपट गाइड: 401, 402, 403, 429 और 5xx
यहीं से शुरू करें। अपना नंबर ढूँढें, फिर नीचे उससे जुड़ा हिस्सा पढ़ें। यह सार 18 नवंबर 2026 तक OpenAI, Anthropic और दूसरे प्रोवाइडरों के एरर पेजों पर आधारित है।
| कोड | आम तौर पर मतलब | क्या इंतज़ार से ठीक होगा? | क्या करें |
|---|---|---|---|
| 401 | key ग़लत है: कोई अक्षर छूटा है, फ़ालतू स्पेस है, key मिटा दी गई है, या key किसी दूसरे प्रोवाइडर या रीजन की है | नहीं | key दोबारा कॉपी करें या नई बनाएँ; प्रोवाइडर और रीजन जाँचें |
| 402 | पेमेंट चाहिए: प्रीपेड बैलेंस या क्रेडिट ख़त्म हो गए, या बिलिंग में कोई दिक़्क़त है | नहीं | टॉप-अप करें, या प्रोवाइडर के बिलिंग पेज पर पेमेंट का तरीक़ा ठीक करें |
| 403 | key चलती है पर इजाज़त नहीं है: देश या रीजन सपोर्टेड नहीं, उस मॉडल का एक्सेस नहीं, या कोई वेरिफ़िकेशन बाक़ी है | नहीं | सपोर्टेड रीजन, key की परमिशन और कोई बाक़ी वेरिफ़िकेशन जाँचें |
| 404 | मॉडल का नाम या पता ग़लत है | नहीं | दूसरा मॉडल चुनें या पता जाँचें |
| 429 | कम समय में बहुत ज़्यादा रिक्वेस्ट, या कुछ प्रोवाइडरों पर ख़ाली बैलेंस या खर्च की लिमिट | अक्सर, अगर रेट लिमिट है | रुककर दोबारा कोशिश करें; मैसेज में quota, balance, credit या spend limit लिखा हो, तो टॉप-अप करें या लिमिट बढ़ाएँ |
| 500–504, 529 | प्रोवाइडर की तरफ़ ख़राबी या भीड़ | आम तौर पर हाँ | बाद में कोशिश करें या मॉडल बदलें |
insufficient balance या quota क्यों लिखा आता है?
ज़्यादातर प्रोवाइडरों पर API चलाने से पहले प्रीपेड क्रेडिट या चालू बिलिंग चाहिए, और हर प्रोवाइडर ख़ाली बैलेंस को अपने ढंग से बताता है। इनमें से किसी भी हालत में नई key से कुछ नहीं होगा; क्रेडिट डालने से होगा।
नीचे Oriveo के 15 बिल्ट-इन प्रोवाइडरों में से हर एक का वह कोड है, जो बैलेंस या क्रेडिट ख़त्म होने पर उसके दस्तावेज़ों में बताया गया है। "नहीं बताया" का मतलब है कि 18 नवंबर 2026 को जाँचे गए प्रोवाइडर के दस्तावेज़ों में इस हालत का HTTP कोड नहीं दिया गया।
| प्रोवाइडर | बैलेंस ख़त्म होने पर कोड | मैसेज में क्या लिखा होता है | आधिकारिक पेज |
|---|---|---|---|
| OpenAI | 429 | credit_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 Gemini | 402 (प्रीपेड बिलिंग) | payment_required; 403 का मतलब Cloud Billing पर बकाया बैलेंस भी हो सकता है | aistudio.google.com/docs/api-errors |
| OpenRouter | 402 | आपके अकाउंट या API key में पर्याप्त क्रेडिट नहीं हैं | openrouter.ai/docs/api-reference/errors |
| DeepSeek | 402 | Insufficient Balance | api-docs.deepseek.com/quick_start/error_codes |
| xAI (Grok) | नहीं बताया | प्रीपेड क्रेडिट ख़त्म होते ही रिक्वेस्ट ठुकरा दी जाती हैं | docs.x.ai/console/billing |
| Mistral AI | 402 | Payment required | docs.mistral.ai/resources/error-glossary |
| Groq | दस्तावेज़ में नहीं | Groq इस्तेमाल के बाद बिल करता है; उसके एरर पेज पर बैलेंस का कोई एरर नहीं है | 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 | नहीं बताया (बिज़नेस कोड 1008) | insufficient balance | platform.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) | 403 | Arrearage या isv.OUT_OF_SERVICE (अकाउंट पर बकाया) | alibabacloud.com/help/en/model-studio/error-code |
| Kimi (Moonshot AI) | 429 | exceeded_current_quota_error | platform.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 ने प्रोवाइडर सेव कर लिया, पर जाँच के दौरान प्रोवाइडर ने 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 कहे "यह कनेक्शन अपने अपस्ट्रीम प्रोवाइडर तक नहीं पहुँच सका।", तो हो सकता है कि प्रोवाइडर के पास उस सर्विस का अपना अकाउंट अमान्य हो, उसके क्रेडिट ख़त्म हों या उस पर रेट लिमिट लगी हो। यह आपकी कॉन्फ़िगरेशन की ग़लती नहीं है; कोई दूसरा कनेक्शन चुनें या सर्विस चलाने वाले से संपर्क करें।
नई key बनाने से पहले ये जाँच लें
नई key से 401 ठीक होता है, और ज़्यादा कुछ नहीं। पहले यह सूची देख लें:
- आपने सही प्रोवाइडर चुना है, और Kimi, MiniMax, Qwen, SiliconFlow और Z.ai के लिए सही रीजन भी।
- आपने पूरी key कॉपी की है, बिना स्पेस के।
- अकाउंट में क्रेडिट है, या बिलिंग का कोई चालू तरीक़ा जुड़ा है।
- आपका देश या रीजन प्रोवाइडर की सपोर्टेड सूची में है।
- आपका चुना मॉडल आपके अकाउंट या टियर पर उपलब्ध है।
ऐप से जुड़े आम सवाल
मेरी API key काम क्यों नहीं कर रही?
API key पर 401 एरर का क्या मतलब है?
402 Payment Required एरर क्या है?
429 एरर रेट लिमिट है या कोटा की दिक़्क़त?
मेरी OpenAI API key insufficient_quota क्यों दिखा रही है?
सही कॉपी करने के बाद भी मेरी नई API key क्यों नहीं चल रही?
इनसे जुड़े आर्टिकल
ब्लॉग से
हर key के एरर आसान भाषा में समझें
वेब ऐप खोलें या iPhone या Android के लिए Oriveo डाउनलोड करें, 15 प्रोवाइडरों की key जोड़ें, और कोई रिक्वेस्ट फ़ेल हो तो उसकी साफ़ वजह जानें।
अभी API key नहीं है? Oriveo Free से बिना key के शुरू करें।