kimiapikey.comमार्गदर्शिका
Moonshot API Base URL: अपना कोड दूसरी जगह निर्देशित करें
moonshot api base url आपकी OpenAI-शैली क्लाइंट में केवल एक स्ट्रिंग है, और इसे बदलना उसी कोड को एक अलग प्रदाता की ओर निर्देशित करने का तरीका है। यह पृष्ठ दिखाता है कि वह स्ट्रिंग Python, Node, curl और सामान्य उपकरणों में कहाँ रहती है, और इसे एक वैकल्पिक एंडपॉइंट पर कैसे निर्देशित करें।
अपडेट किया गया


मुख्य बिंदु
- base URL एक एकल सेटिंग है; अनुरोध बॉडी OpenAI चैट प्रारूप में ही रहती है।
- जब आप स्विच करते हैं तो तीन चीजें बदलें: base URL, API कुंजी, model ID।
- हमारा एंडपॉइंट https://api.kimiapikey.com/v1 है और मॉडल ID uncensored है।
- यह एक स्वतंत्र होस्टेड मॉडल है, Moonshot की आधिकारिक सेवा नहीं है, इसलिए अपने प्रॉम्प्ट का पुनः परीक्षण करें।
base URL वास्तव में क्या करता है
OpenAI-संगत क्लाइंट प्रत्येक अनुरोध दो भागों से बनाते हैं: बेस यूआरएल और एक पथ। SDK उन्हें जोड़ता है, इसलिए chat.completions.create पर कॉल करना <base_url>/chat/completions पर एक POST बन जाता है। इस प्रारूप का पालन करने वाले प्रदाता, जिनमें Moonshot भी शामिल है, अपनी बेस यूआरएल दस्तावेज़ीकरण में प्रकाशित करते हैं। इसे वहाँ देखें, फोरम पोस्ट से कॉपी करने के बजाय, क्योंकि यह वह एकमात्र मान है जिसे आप अनुमान नहीं लगा सकते।
इसलिए प्रदाता बदलने के लिए केवल तीन संपादन और कुछ नहीं चाहिए:
- Base URL, जो तय करता है कि अनुरोध कहाँ जाएगा।
- API कुंजी, जो प्रत्येक प्रदाता के लिए जारी की जाती है और केवल उसी प्रदाता के सर्वर पर काम करती है।
- मॉडल ID, क्योंकि हर प्रदाता अपने मॉडल्स को अलग नाम देता है।
संदेश, भूमिकाएँ, स्ट्रीमिंग, टूल्स और JSON मोड का प्रारूप समान रहता है, इसलिए माइग्रेशन छोटा है। किसी प्रदाता-विशिष्ट सुविधा पर निर्भर किसी भी चीज़, जैसे कि एक इनबिल्ट वेब सर्च टूल, के लिए अलग से हैंडलिंग की आवश्यकता होगी।
यह प्रत्येक प्रदाता के लिए एक कॉन्फ़िग ब्लॉक या एक एन्वायरनमेंट फ़ाइल में तीन मानों को एक साथ रखने में भी मदद करता है। जब बेस यूआरएल, कुंजी और मॉडल ID एक साथ होती हैं, तो वापस स्विच करना एक लाइन का बदलाव है, और आप आधे-माइग्रेटेड स्टेट से बच जाते हैं जहाँ एक नई कुंजी एक पुरानी एड्रेस के साथ जुड़ी होती है।
पायथन: openai पैकेज
Python में, आप क्लाइंट बनाते समय base URL सेट करते हैं। यह उदाहरण इस साइट के एंडपॉइंट से बात करता है:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
यदि आप कोड से सेटिंग्स को मुक्त रखना चाहते हैं, तो एन्वायरनमेंट का उपयोग करें। SDK OPENAI_BASE_URL और OPENAI_API_KEY पढ़ता है जब आप OpenAI() को बिना किसी आर्गुमेंट के कॉल करते हैं, इसलिए एक डिप्लॉयमेंट बिना कोड बदले प्रदाता बदल सकता है। ध्यान रखें कि इसका मतलब यह भी है कि आपके शेल में बचा हुआ एक वेरिएबल फ़ाइल में लिखे गए मान को ओवरराइड कर सकता है।
Node और curl
आधिकारिक जावास्क्रिप्ट पैकेज समान ऑप्शन नाम का उपयोग करता है, कैमल केस में लिखा गया:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kimiapikey.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
बिल्कुल भी SDK के बिना, बेस यूआरएल पता का केवल आदि भाग है:
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
वही एंडपॉइंट POST /v1/responses भी स्वीकार करता है, और GET /v1/models सूचीबद्ध करता है कि यह क्या सर्व करता है। प्रत्येक मामले में प्रमाणीकरण एक bearer token है Authorization हेडर में।
संपादक और चैट फ्रंटएंड
GUI टूल्स base URL को अलग-अलग लेबल्स के तहत दिखाते हैं: "API base", "Override OpenAI Base URL", "Custom endpoint" या "Provider URL"। आप जो स्ट्रिंग पेस्ट करते हैं, वह ऊपर दिए गए कोड में उसी स्ट्रिंग के बराबर है, जो /v1 पर समाप्त होती है। जब तक टूल पूरा URL मांगता है, तब तक पूरा /chat/completions एड्रेस पेस्ट न करें।
सेव करने के बाद, यदि टूल सूची फ़ेच नहीं करता है तो मॉडल ID मैन्युअल रूप से जोड़ें। कुछ संपादक कुंजी को एक फिक्स्ड प्रदाता के खिलाफ वैलिडेट करते हैं और कस्टम मानों को अस्वीकार कर देते हैं, ऐसे मामले में पहले एक सेटिंग ढूंढें जो कस्टम या OpenAI-संगत मोड को चालू करती है। Cursor में Kimi-शैली API कुंजी का उपयोग पर आर्टिकल ऐसे ही एक टूल को विस्तार से समझाता है।
प्रदाता बदलने पर क्या बदलता है
मेल खाने वाला फॉर्मेट मतलब मेल खाने वाला व्यवहार नहीं है। उत्पादन ट्रैफ़िक ले जाने से पहले, इन बिंदुओं को एक-एक करके जाँचें:
- आउटपुट शैली। एक अलग मॉडल अलग लिखता है। अपने असली प्रॉम्प्ट चलाएं, कोई टॉय उदाहरण नहीं।
- संदर्भ आकार। एंडपॉइंट पर प्रॉम्प्ट और पूर्णता के योग के लिए 100,000 टोकन विंडो है। यदि आपका वर्तमान सेटअप लंबे प्रॉम्प्ट भेजता है, तो पहले उन्हें ट्रिम करें।
- सीमाएँ। एक पूर्ण कुंजी 8 समकालिक अनुरोधों और प्रति मिनट 300 की अनुमति देती है। किसी भी एक सीमा से अधिक होने पर आपको HTTP 429 मिलता है,
rate_limitedयाconcurrencyकोड के साथ। - फीचर्स। SSE पर स्ट्रीमिंग, टूल कॉलिंग और JSON मोड समर्थित हैं। इमेज, ऑडियो और वीडियो जनरेशन, एम्बेडिंग्स और फाइन-ट्यूनिंग नहीं; यह एक टेक्स्ट-ओनली API है।
- नामकरण। सेवा एक ओपन-वेट मॉडल चलाती है जिसे कानूनी वयस्कों के उपयोग के लिए बिना सामग्री अस्वीकृतियों के उत्तर देने के लिए चुना गया है। यह Moonshot की आधिकारिक API नहीं है और न ही यह विभिन्न प्रदाताओं के बीच एक रूटर है।
तुलना का एक तटस्थ तरीका दोनों एंडपॉइंट्स के माध्यम से समान दस प्रॉम्प्ट लॉग करना और जवाबों को साइड-बाय-साइड पढ़ना है। इसमें मिनट लगते हैं और अनुमान लगाने की मेहनत बचती है।
Base URL की गलतियाँ और वे कैसी दिखती हैं
स्विच के बाद अधिकांश विफलताएं key की नहीं, बल्कि address की होती हैं। यहाँ हर गलती कैसे दिखती है और उसे कैसे ठीक करें, यह बताया गया है।
| गलती | लक्षण | समाधान |
|---|---|---|
केवल होस्ट, /v1 नहीं | हर कॉल पर 404 | /v1 को अंत में जोड़ें |
| पूरा पथ पेस्ट किया गया | त्रुटि में दोहराया गया पथ के साथ 404 | पता वापस /v1 पर काटें |
| ट्रेलिंग स्लैस और मैन्युअल पथ जोड़ना | URL में डबल स्लैश | SDK को पथ जोड़ने दें |
| पुरानी कुंजी, नया URL | 401 | नए प्रदाता द्वारा जारी की गई कुंजी का उपयोग करें |
| पुराना URL, नई कुंजी | पुराने प्रदाता से 401 | पुराने पते के लिए रिपॉजिटरी और शेल में खोजें |
http:// का उपयोग https:// के बजाय | रिडायरेक्ट या कनेक्शन त्रुटि | सभी जगह https का उपयोग करें |
शेष बचे पते को खोजने का एक तेज़ तरीका यह है कि आप अपने प्रोजेक्ट और डिप्लॉयमेंट सेटिंग्स में पुराने होस्ट नाम की खोज करें। .env फ़ाइलों, CI वेरिएबल्स, Docker compose फ़ाइलों और किसी भी एडिटर सेटिंग्स में देखें, क्योंकि एक भुला हुआ कॉपी भी कुछ ट्रैफ़िक को पुराने प्रदाता की ओर भेजने के लिए पर्याप्त है।
स्विच करने के बाद स्ट्रीमिंग और टूल्स
stream: true सेट करें और रिप्लाई सर्वर-सेंट इवेंट्स के रूप में आता है, जिसमें टोकन उपयोग अंत में रिपोर्ट किया जाता है। टूल कॉलिंग सामान्य tools और tool_choice फ़ील्ड्स का उपयोग करती है, स्ट्रीम्ड tool_calls और परिणाम messages के रूप में role: "tool" के साथ वापस भेजे जाते हैं। यदि आपका कोड पहले से इनका पालन कर रहा है, तो उसे काम करना चाहिए; पूरी तरह से कटओवर करने से पहले एक स्ट्रीम्ड कॉल और एक टूल कॉल चलाकर पुष्टि करें। याद रखें कि एक स्ट्रीम्ड अनुरोध स्ट्रीम खत्म होने तक अपनी कॉन्करेंसी स्लॉट रखता है।
स्विच करने से पहले लागत जाँच
यहाँ बिलिंग प्रति टोकन है: 1M इनपुट टोकन के लिए $0.15 और 1M आउटपुट टोकन के लिए $0.50, प्रीपेड क्रेडिट से, कोई सब्सक्रिप्शन नहीं। विफल या सर्वर द्वारा अस्वीकृत अनुरोधों के लिए चार्ज नहीं किया जाता है, और क्रेडिट समाप्त नहीं होता है। किसी अन्य प्रदाता की दरें देखने के लिए, उनकी वर्तमान मूल्य निर्धारण पृष्ठ पर जाएं, क्योंकि वे बदलती रहती हैं।
एक कार्य-उदाहरण। मान लीजिए एक अनुरोध में 2,000 इनपुट टोकन और 500 आउटपुट टोकन हैं:
- इनपुट: 2,000 / 1,000,000 × $0.15 = $0.0003
- आउटपुट: 500 / 1,000,000 × $0.50 = $0.00025
- कुल: प्रति अनुरोध $0.00055, इसलिए 1,000 अनुरोधों की लागत $0.55 है
न्यूनतम टॉप-अप $20 है, और बड़े टॉप-अप पर बोनस मिलता है: $50 से +5%, $100 से +10% और $200 से +15%। केवल क्रिप्टो (TRC20 पर USDT, Base पर USDC) स्वीकार किए जाते हैं। विस्तृत जानकारी मूल्य निर्धारण पृष्ठ पर है, और Kimi-केंद्रित विवरण Kimi API कुंजी मूल्य निर्धारण में है।
एक कुंजी प्राप्त करें और पहला कॉल चलाएँ
Google या ईमेल और पासवर्ड से साइन अप करें, फिर API कुंजी पेज खोलें। नए उपयोगकर्ता एक क्लिक में $0.50 का ट्रायल क्रेडिट क्लेम कर सकते हैं, प्रति व्यक्ति एक, जो 7 दिनों के लिए मान्य है और कार्ड की आवश्यकता नहीं है। ट्रायल कुंजियां 2 समकालिक अनुरोधों और प्रति मिनट 60 अनुरोधों तक सीमित हैं, जो एक टेस्ट रन के लिए पर्याप्त है।
कुंजी को ऊपर दिए गए Python स्निपेट में पेस्ट करें, इसे चलाएं और पुष्टि करें कि आपको टेक्स्ट वापस मिलता है। दस्तावेज़ में हर पैरामीटर की सूची है, और रिस्पॉन्स हेडर X-Request-Id और X-Balance-USD डीबगिंग और बैलेंस ट्रैकिंग में मदद करते हैं। सेवा को भेजे गए प्रॉम्प्ट्स को ट्रेनिंग के लिए इस्तेमाल नहीं किया जाता है।
अधिक गाइड
- Kimi API कुंजी काम नहीं कर रही: कारण, समाधान, फॉलबैक
- Cursor में Kimi-स्टाइल API कुंजी का उपयोग करें: सेटअप गाइड
अक्सर पूछे जाने वाले प्रश्न
क्या मॉडल Moonshot के आधिकारिक Kimi के समान है?
नहीं, हम एक ऐसा ओपन-वेट मॉडल होस्ट करते हैं जिसे बिना सेंसर होने के लिए ट्यून किया गया है। यह GPT, Claude, Gemini, Grok, DeepSeek या किसी अन्य वेंडर का मॉडल नहीं है। यह एक विशिष्ट मॉडल है जो हमारे अपने सर्वरों पर चलाया जाता है।
क्या आप मेरे डेटा पर ट्रेनिंग करते हैं?
नहीं। आपके प्रॉम्प्ट और कम्प्लीशन्स ट्रेनिंग के लिए उपयोग नहीं किए जाते हैं। हम गोपनीयता और पारदर्शिता का सम्मान करते हैं, इसलिए आपका डेटा आपका ही रहता है।
रेट लिमिट क्या हैं?
आप प्रति कुंजी प्रति मिनट 300 अनुरोधों तक सीमित हैं। अधिकतम अनुरोध बॉडी आकार 8 MB है। ये सीमाएँ सभी उपयोगकर्ताओं के लिए स्थिर प्रदर्शन सुनिश्चित करने के लिए डिज़ाइन की गई हैं।
कंटेंट पॉलिसी क्या है?
मॉडल वयस्क, विवादास्पद और रचनात्मक विषयों के संबंध में बिना सेंसर है। हालाँकि, हम नाबालिगों से जुड़ी यौन सामग्री को ब्लॉक करते हैं। यह एक कठोर सीमा है जो हमेशा लागू होती है, आपकी सब्सक्रिप्शन स्तर से स्वतंत्र।
प्रश्न और उत्तर
क्या मुझे बेस URL बदलते समय अपने कोड को बदलने की आवश्यकता है?
आमतौर पर केवल तीन मान: बेस URL, API कुंजी और मॉडल ID। संदेश प्रारूप, स्ट्रीमिंग और टूल कॉलिंग वही रहते हैं, जब तक कि नया प्रदाता उन्हें समर्थित करता हो।
क्या बेस URL /v1 के साथ समाप्त होना चाहिए?
इस एंडपॉइंट के लिए हाँ: https://api.kimiapikey.com/v1. SDK स्वयं /chat/completions जोड़ देता है, इसलिए इसे शामिल न करें।
क्या यह आधिकारिक Moonshot API है?
नहीं। यह एक स्वतंत्र रूप से होस्ट किया गया ओपन-वेट मॉडल है जो OpenAI-संगत API के पीछे है। यह Moonshot की सेवा नहीं है और न ही यह विभिन्न प्रदाताओं के बीच एक राउटर है।
मॉडल ID कहाँ मिलती है?
अपनी कुंजी के साथ GET /v1/models कॉल करें। इस एंडपॉइंट पर मॉडल ID uncensored है।
आपकी कुंजी बस एक फ़ॉर्म दूर है
एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।