HI ▾
API कुंजी प्राप्त करें

kimiapikey.comमार्गदर्शिका

Kimi API कुंजी काम नहीं कर रही: कारण, समाधान, फॉलबैक

यदि आपकी «Kimi API कुंजी काम नहीं कर रही» त्रुटि 401, 404 या 429 के रूप में दिखाई देती है, तो कारण लगभग हमेशा पांच चीजों में से कोई एक होता है: गलत बेस URL, मेल न खाने वाली कुंजी, बैलेंस न होना, रेट लिमिट, या वह मॉडल नाम जो एंडपॉइंट नहीं जानता। इन्हें इसी क्रम में जांचें।

अपडेट किया गया

एक कुंजी एक ताले में फँसी है जबकि एक हरा मार्ग दूसरे खुले ताले की ओर जाता है, जो एक फॉलबैक API एंडपॉइंट का प्रतीक है
स्टेटस एडिटर का आइसोमेट्रिक चित्रण जो एक चमकदार केबल द्वारा API सर्वर से जुड़ा है

मुख्य बिंदु

  • एक कुंजी केवल उसी प्रदाता के लिए काम करती है जिसने उसे जारी किया है, इसलिए आधार URL और कुंजी एक ही डैशबोर्ड से आनी चाहिए।
  • 401 का मतलब है कि कुंजी को अस्वीकार कर दिया गया, 404 आमतौर पर खराब पथ का संकेत देता है, 429 का मतलब है कि आपने एक सीमा को छू लिया है या सेवा व्यस्त है।
  • कुछ भी अन्य बदलने से पहले स्टेटस कोड और प्रतिक्रिया बॉडी प्रिंट करें।
  • एक दूसरा OpenAI-संगत एंडपॉइंट कॉन्फ़िगर रखें ताकि एक आउटेज आपके ऐप को रोक न दे।

पहले स्टेटस कोड पढ़ें

कुछ भी रीजेनरेट करने से पहले देखें कि सर्वर ने वास्तव में क्या कहा। अधिकांश OpenAI-शैली के क्लाइंट बॉडी को एक सामान्य अपवाद के पीछे छुपा देते हैं। स्टेटस और टेक्स्ट दोनों प्रिंट करें।

curl -i https://api.kimiapikey.com/v1/models \
  -H "Authorization: Bearer $YOUR_KEY"

जवाब की पहली पंक्ति आपको बताती है कि कहाँ देखना है:

स्टेटससामान्य अर्थइससे शुरू करें
401कुंजी अस्वीकृतकुंजी कॉपी, कुंजी और बेस URL अलग-अलग प्रदाताओं की हैं
404पथ या मॉडल नहीं मिला/v1 गायब है, पथ दोगुना है, गलत मॉडल ID
400अनुरोध बॉडी अमान्यपैरामीटर नाम, संदेश प्रारूप, बॉडी का आकार
429सीमा पार हो गई या सेवा व्यस्त हैअनुरोध दर, समानांतर कॉल, पुनः प्रयास का समय
5xxसर्वर पक्ष की समस्याबैकऑफ़ के साथ पुनः प्रयास करें, फिर फॉलबैक पर स्विच करें

यदि आपको बिल्कुल भी कोई HTTP प्रतिक्रिया नहीं मिलती (टाइमआउट या DNS त्रुटि), तो समस्या नेटवर्क या उस होस्टनाम में है जिसे आपने टाइप किया है, न कि कुंजी में।

बेस URL और कुंजी एक-दूसरे के अनुरूप होने चाहिए

यह नई कुंजी के काम न करने का सबसे सामान्य कारण है। कुंजियाँ प्रदाता के अनुसार जारी की जाती हैं। एक डैशबोर्ड से प्राप्त कुंजी दूसरे प्रदाता के सर्वरों के लिए अज्ञात होती है, इसलिए वह 401 लौटाती है भले ही वह कुंजी जहाँ से आई है वहाँ पूरी तरह मान्य हो।

इन बिंदुओं की जाँच करें:

  • कुंजी और बेस URL एक ही अकाउंट पेज से आते हैं। यदि आपने कुंजी एक प्रदाता से कॉपी की है और कॉन्फ़िगरेशन में पुराना बेस URL छोड़ दिया है, तो अनुरोध गलत जगह जाता है।
  • एनवायरनमेंट वेरिएबल आपके कोड को ओवरराइड नहीं कर रहे हैं। जब आप उन्हें स्पष्ट रूप से पास नहीं करते, तो OpenAI SDK OPENAI_API_KEY और OPENAI_BASE_URL पढ़ता है, इसलिए एक पुराना शेल वेरिएबल आपके फ़ाइल में लिखे मान को ओवरराइड कर सकता है।
  • कुंजी के अंत में कोई स्पेस या नई लाइन नहीं होनी चाहिए। कॉपी-पेस्ट से आया ट्रेलिंग न्यूलाइन 401 का एक सामान्य कारण है।
  • हेडर बिल्कुल Authorization: Bearer <key> है। कुछ टूल्स कुंजी को अलग हेडर में अपेक्षित करते हैं और OpenAI-संगत मोड को चालू करने की आवश्यकता होती है।

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

बेस URL /v1 पर समाप्त होना चाहिए, होस्ट पर नहीं और न ही /v1/chat/completions पर। SDK शेष भाग जोड़ देता है। एक URL जो पहले से ही पूर्ण पथ शामिल करता है, वह दोगुना पथ और 404 बना देता है।

क्षेत्रीय एक्सेस, प्रॉक्सी और कॉर्पोरेट नेटवर्क

कभी-कभी कुंजी ठीक होती है और अनुरोध सही सर्वर तक नहीं पहुँचता। प्रदाता की उपलब्धता इस बात पर निर्भर कर सकती है कि आप कहाँ से कनेक्ट कर रहे हैं, और एक VPN, कॉर्पोरेट प्रॉक्सी या फ़ायरवॉल नियम ट्राफ़िक को ब्लॉक या रीराइट कर सकता है। उनके समर्थित क्षेत्रों के लिए प्रदाता की अपनी दस्तावेज़ीकरण या स्टेटस पेज देखें, और यह न मानें कि नियम किसी अन्य सेवा के समान हैं।

एक त्वरित अलगाव परीक्षण: अलग नेटवर्क, जैसे कि फोन हॉटस्पॉट से वही curl कमांड चलाएं। यदि वहाँ यह काम करता है, तो कुंजी ठीक है और आपका नेटवर्क ही कारण है। यदि प्रॉक्सी HTTPS_PROXY सेट करता है, तो जांचें कि आपकी HTTP लाइब्रेरी वास्तव में उसका सम्मान करती है या नहीं; कुछ टूल्स इसे अनदेखा करते हैं और कनेक्शन त्रुटि के साथ विफल हो जाते हैं।

बैलेंस, क्वाटा और रेट लिमिट कैसा दिखता है

एक कुंजी वैध हो सकती है और फिर भी अनुरोधों को अस्वीकार कर सकती है क्योंकि खाते में क्रेडिट शेष नहीं है या क्वाटा समाप्त हो चुका है। कोड डिबग करने से पहले डैशबोर्ड जांचें। यदि आपने कभी टॉप-अप नहीं किया है, तो याद रखें कि मुफ्त अनुमतियाँ आमतौर पर छोटी और अस्थायी होती हैं।

429 की स्थिति अलग है। इसका मतलब है कि सर्वर आपकी गति कम कर रहा है, न कि कुंजी खराब है। इस साइट पर वर्णित एंडपॉइंट पर, पूर्ण कुंजी 8 समकालीय अनुरोधों और प्रति मिनट 300 अनुरोधों की अनुमति देती है, और ट्रायल कुंजी 2 समकालीय और प्रति मिनट 60 की अनुमति देती है। जब आप इन्हें पार कर जाते हैं, तो API HTTP 429 rate_limited (प्रति मिनट बहुत अधिक) या concurrency (एक साथ बहुत अधिक) त्रुटि कोड के साथ लौटाता है। अस्थायी ओवरलोड भी 429 लौटाता है, Retry-After: 5 हेडर के साथ।

इनमें से अधिकांश समस्याओं को दो आदतें ठीक करती हैं। जब Retry-After मौजूद हो तो उसका सम्मान करें, और अपने समानांतर वर्कर को कन्करेंसी लिमिट तक सीमित करें। एक स्ट्रीमिंग अनुरोध स्ट्रीम समाप्त होने तक अपना स्लॉट रखता है, इसलिए एक रुकी हुई स्ट्रीम आपको उम्मीद से अधिक समय तक प्रभावित करती है।

मॉडल नाम, पैरामीटर और बॉडी साइज़

एक 404 या एक वैध कुंजी के साथ 400 आमतौर पर अनुरोध की ओर इशारा करता है। जांचने के लिए तीन चीज़ें:

  1. मॉडल ID। हर प्रदाता का अपना मॉडल नाम होता है। GET /v1/models से एंडपॉइंट से पूछें कि वह क्या प्रदान करता है, और जवाब से ID कॉपी करें। इस साइट पर ID uncensored है।
  2. पैरामीटर। max_tokens, temperature और response_format जैसे नाम मानक हैं, लेकिन एक प्रदाता केवल एक छोटा समूह स्वीकार कर सकता है। अनुरोध पास होने तक वैकल्पिक फ़ील्ड्स हटा दें, फिर उन्हें एक-एक करके वापस जोड़ें।
  3. साइज़. बहुत बड़े प्रॉम्प्ट बॉडी लिमिट्स के कारण मॉडल तक पहुँचने से पहले विफल हो सकते हैं। यहाँ अधिकतम बॉडी 8 MB है और प्रॉम्प्ट और कंप्लीशन दोनों के लिए कॉन्टेक्स्ट विंडो 100,000 टोकन है।

स्ट्रीमिंग एक और जगह है जहाँ एक काम करने वाली कुंजी टूटी हुई लग सकती है। यदि एक अनुरोध stream: true के बिना सफल होता है और इसके साथ विफल होता है, तो कारण अक्सर एक प्रॉक्सी होता है जो सर्वर-सेंट इवेंट्स को बफर करता है या काट देता है, न कि एंडपॉइंट। पुष्टि करने के लिए स्ट्रीमिंग बंद करें, फिर प्रॉक्सी सेटिंग्स देखें।

यदि आपने केवल मॉडल नाम बदला है और कॉल विफल हो गई है, तो पुष्टि करने के लिए पुराना नाम वापस रखें कि आपकी सेटअप की बाकी चीज़ें ठीक हैं।

एक फॉलबैक एंडपॉइंट तैयार रखें

एक स्वस्थ प्रदाता के भी बुरे घंटे होते हैं। यदि आपका उत्पाद एक ही कुंजी पर निर्भर है, तो एक अकेली विफलता आपकी आउटेज बन जाती है। क्योंकि OpenAI अनुरोध प्रारूप साझा है, आप एक दूसरा एंडपॉइंट कॉन्फ़िगर कर सकते हैं और कुछ लाइनों के साथ स्विच कर सकते हैं।

इस साइट पर एंडपॉइंट OpenAI-कम्पैटिबल है, इसलिए यह एक दूसरे प्रदाता के रूप में फिट बैठता है। यह एक स्वतंत्र होस्टेड ओपन-वेट मॉडल है, Moonshot की आधिकारिक सेवा नहीं है, और यह एक Kimi मॉडल की तरह जवाब नहीं देगा, इसलिए इस पर भरोसा करने से पहले अपने प्रॉम्प्ट टेस्ट करें। यहाँ एक छोटा रैपर है जो प्राथमिकता की कोशिश करता है और त्रुटियों पर फॉलबैक करता है:

import os
from openai import OpenAI

primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
                 api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
                  api_key=os.environ["FALLBACK_KEY"])

def ask(messages):
    try:
        r = primary.chat.completions.create(
            model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
    except Exception as e:
        print("primary failed:", e)
        r = fallback.chat.completions.create(
            model="uncensored", messages=messages, timeout=60)
    return r.choices[0].message.content

print(ask([{"role": "user", "content": "Say hi in five words."}]))

मूल्य निर्धारण पे-एज़-यू-गो है: प्रीपेड क्रेडिट से प्रति 1M इनपुट टोकन के लिए $0.15 और प्रति 1M आउटपुट टोकन के लिए $0.50 जो कभी समाप्त नहीं होता। विफल या अस्वीकृत अनुरोधों के लिए चार्ज नहीं किया जाता है, इसलिए एक फॉलबैक जो दुर्लभ रूप से चलता है, उसे बनाए रखने में लगभग कोई लागत नहीं आती। टॉप-अप $20 से शुरू होते हैं; बोनस टियर के लिए मूल्य निर्धारण देखें।

फॉलबैक को दो मिनट में टेस्ट करें

नए उपयोगकर्ता साइन-अप के बाद API कुंजी पेज पर एक क्लिक के साथ $0.50 का मुफ़्त ट्रायल क्रेडिट दावा कर सकते हैं। इसके लिए कार्ड की आवश्यकता नहीं है और यह 7 दिनों के लिए मान्य है, जो एंडपॉइंट पर अपने असली प्रॉम्प्ट एक बार चलाने के लिए पर्याप्त है। फिर नीचे दिए गए स्मोक टेस्ट को चलाएं।

curl https://api.kimiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $FALLBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

अपना शेष क्रेडिट देखने के लिए X-Balance-USD रिस्पॉन्स हेडर की जांच करें। पूर्ण अनुरोध संदर्भ दस्तावेज़ में है। यदि आप इसे एडिटर में जोड़ रहे हैं, तो Cursor में Kimi-स्टाइल API कुंजी का उपयोग पर मौजूद गाइड बताता है कि बेस URL फ़ील्ड कहाँ है, और Kimi API कुंजी का अवलोकन समझाता है कि यह एंडपॉइंट उस मॉडल से कैसे संबंधित है जिसका आप उपयोग कर रहे थे।

अक्सर पूछे जाने वाले प्रश्न

क्या मॉडल Moonshot के आधिकारिक Kimi के समान है?
नहीं, हम एक ओपन-वेट मॉडल होस्ट करते हैं जिसे बिना सेंसर बनाया गया है। यह GPT, Claude, Gemini, Grok, DeepSeek या किसी अन्य वेंडर का मॉडल नहीं है। यह एक अलग मॉडल है जो हमारे अपने सर्वरों पर चलाया जाता है।

क्या आप मेरे डेटा पर ट्रेनिंग करते हैं?
नहीं। आपके प्रॉम्प्ट और कम्प्लीशन्स ट्रेनिंग के लिए उपयोग नहीं किए जाते हैं। हम गोपनीयता और पारदर्शिता का सम्मान करते हैं, इसलिए आपका डेटा आपका ही रहता है।

रेट लिमिट क्या हैं?
प्रति कुंजी प्रति मिनट 300 अनुरोधों तक सीमित हैं। अधिकतम अनुरोध बॉडी आकार 8 MB है। ये सीमाएँ सभी उपयोगकर्ताओं के लिए स्थिर प्रदर्शन सुनिश्चित करने के लिए डिज़ाइन की गई हैं।

कंटेंट पॉलिसी क्या है?
मॉडल वयस्क, विवादास्पद और रचनात्मक विषयों के संबंध में बिना सेंसर है। हालाँकि, हम नाबालिगों से जुड़े यौन सामग्री को ब्लॉक करते हैं। यह एक कठोर सीमा है जो हमेशा लागू होती है, आपकी सब्सक्रिप्शन स्तर से स्वतंत्र।

प्रश्न और उत्तर

मेरी नई कुंजी तुरंत 401 क्यों लौटाती है?

सबसे सामान्य कारण हैं: कुंजी किसी अलग प्रदाता के बेस URL पर भेजी गई हो, कॉपी की गई कुंजी में अवांछित स्पेस या नया लाइन हो, या पर्यावरण चर आपकी कोड को ओवरराइड कर रहा हो। अपने SDK को बाहर करने के लिए curl से टेस्ट करें।

क्या 429 एक खराब कुंजी के समान है?

नहीं। 429 का मतलब है कि आपने रेट लिमिट, कन्करेंसी लिमिट या अस्थायी ओवरलोड को छुआ है। कुंजी वैध है। Retry-After मान के लिए प्रतीक्षा करें और अपने समानांतर अनुरोध कम करें।

क्या यहाँ विफल अनुरोधों के लिए पैसे खर्च होते हैं?

नहीं। इस एंडपॉइंट पर विफल या अस्वीकृत अनुरोधों के लिए चार्ज नहीं किया जाता है, इसलिए एक टूटे कॉल को पुनः प्रयास करने से आपका क्रेडिट खत्म नहीं होता।

क्या मैं इस एंडपॉइंट का उपयोग Kimi मॉडल के लिए ड्रॉप-इन के रूप में कर सकता हूँ?

यह एक ही OpenAI अनुरोध प्रारूप का उपयोग करता है, इसलिए कोड में बदलाव बेस URL, कुंजी और मॉडल ID uncensored में होता है। अंडरलाइंग मॉडल अलग है, इसलिए प्रतिक्रियाएं मेल नहीं खाएंगी; पहले अपने प्रॉम्प्ट टेस्ट करें।

आपकी कुंजी बस एक फॉर्म दूर है

एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।

API कुंजी पाएँदस्तावेज़ पढ़ें