kimiapikey.comDocs
Kimi API: पाँच मिनट में पहला अनुरोध
मानक OpenAI-संगत इंटरफ़ेस का उपयोग करके पाँच मिनट से कम समय में अपनी पहली प्रतिक्रिया प्राप्त करें। यह गाइड सेटअप, प्रमाणीकरण और बिना सेंसर मॉडल के लिए बुनियादी उपयोग को कवर करती है।
पूर्वशर्तें
शुरू करने के लिए, आपको kimiapikey.com से API कुंजी की आवश्यकता है। केवल ईमेल और पासवर्ड से साइन अप करें; ट्रायल के लिए क्रेडिट कार्ड की आवश्यकता नहीं है। आपको एक समर्थित भाषा वातावरण की भी आवश्यकता है जिसमें आधिकारिक या संगत SDK स्थापित हो। हमारा API OpenAI चैट-पूर्णता प्रारूप का पालन करता है, इसलिए GPT-3.5/4 के लिए मौजूदा कोड अक्सर न्यूनतम परिवर्तनों के साथ काम करता है। सुनिश्चित करें कि आपका SDK संस्करण base_url पैरामीटर का समर्थन करने के लिए पर्याप्त नवीन है।
बेस URL और प्रमाणीकरण
हमारा API https://api.kimiapikey.com/v1 पर स्थित है। प्रमाणीकरण मानक Authorization हेडर के माध्यम से किया जाता है। अपनी कुंजी Bearer टोकन के रूप में पास करें। यह किसी भी क्लाइंट के साथ काम करता है जो OpenAI-संगत एंडपॉइंट स्वीकार करता है। यदि आप प्रॉक्सी या कस्टम क्लाइंट का उपयोग कर रहे हैं, तो सुनिश्चित करें कि यह Authorization हेडर को सही तरीके से आगे बढ़ाता है। मॉडल ID जिसे आप अनुरोध करेंगे वह uncensored है।
पहला अनुरोध
अपनी सेटअप की पुष्टि करने के लिए एक सरल चैट पूर्ति भेजें। नीचे दिए गए curl कमांड का उपयोग करें, YOUR_API_KEY को अपनी वास्तविक कुंजी से बदलें। यह अनुरोध uncensored मॉडल को एक छोटा प्रॉम्प्ट भेजता है। यदि सफलता मिलती है, तो आपको मॉडल के उत्तर वाले JSON प्रतिक्रिया प्राप्त होगी। जनरेटेड टेक्स्ट के लिए choices सरणी की जाँच करें। यदि आपको 401 त्रुटि मिलती है, तो आपकी कुंजी अमान्य या समाप्त हो चुकी है।
Python SDK
सबसे आसान इंटीग्रेशन के लिए आधिकारिक OpenAI Python लाइब्रेरी का उपयोग करें। हमारे एंडपॉइंट के लिए base_url सेट करें और अपनी कुंजी प्रदान करें। यह उदाहरण एक बुनियादी टेक्स्ट जनरेशन कॉल को दर्शाता है। यदि आवश्यक हो तो आप model पैरामीटर को समायोजित कर सकते हैं, हालाँकि uncensored डिफ़ॉल्ट है। यह दृष्टिकोण आपके कोड को विभिन्न OpenAI-संगत सेवाओं के बीच पोर्टेबल बनाए रखता है।
Node SDK
JavaScript/TypeScript प्रोजेक्ट्स के लिए, openai npm पैकेज का उपयोग करें। हमारे बेस URL और अपनी API कुंजी के साथ क्लाइंट कॉन्फ़िगर करें। इससे आप अपने Node वातावरण से सीधे अनुरोध कर सकते हैं। इसका सिंटैक्स Python SDK जैसा है, जिससे भाषा बदलने पर भी स्थिरता बनी रहती है। await का उपयोग करके एसेंक्रोनस प्रतिक्रियाओं को सही ढंग से हैंडल करना न भूलें।
स्ट्रीमिंग प्रतिक्रियाएँ
वास्तविक समय आउटपुट के लिए, अपने SDK में स्ट्रीमिंग सक्षम करें। यह टेक्स्ट के चंक को जनरेट होते ही भेजता है, जिससे अनुभवजन्य विलंब कम होती है। अपने अनुरोध में stream फ्लैग का उपयोग करें। SDK आंशिक प्रतिक्रियाएँ देगा, जिससे आप UI को क्रमिक रूप से अपडेट कर सकेंगे। यह चैट इंटरफ़ेस या लंबी सामग्री जनरेशन के लिए आदर्श है जहाँ तत्कल प्रतिक्रिया मूल्यवान होती है।
सीमाएँ और त्रुटियाँ
प्रत्येक कुंजी प्रति मिनट 300 अनुरोधों तक सीमित है। यदि आप इससे अधिक करते हैं, तो आपको 429 त्रुटि मिलेगी। आपके अनुरोध बॉडी का आकार 8 MB से अधिक नहीं होना चाहिए। 100,000 टोकन की कॉन्टेक्स्ट विंडो प्रॉम्प्ट और पूर्ति के योग पर लागू होती है। सामान्य त्रुटियों में 401 (अमान्य कुंजी) और 402 (अपर्याप्त क्रेडिट) शामिल हैं। डैशबोर्ड के माध्यम से टॉप-अप करें ताकि API का उपयोग जारी रख सकें। क्रेडिट कभी समाप्त नहीं होते, और कोई मासिक शुल्क नहीं है।
cURL
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": "Write a blunt product review of a cheap VPN."}]
}'Python
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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);स्ट्रीमिंग
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)प्रश्न और उत्तर
क्या API फ़ंक्शन कॉलिंग का समर्थन करता है?
हाँ, एंडपॉइंट मानक OpenAI फॉर्मेट में टूल/फ़ंक्शन कॉलिंग का समर्थन करता है। आप अपने अनुरोध में टूल परिभाषित कर सकते हैं और मॉडल संरचित तर्क लौटाएगा।
यदि मैं रेट लिमिट से अधिक हो जाता हूँ तो क्या होता है?
आपको 429 Too Many Requests त्रुटि प्राप्त होगी। थोड़ा प्रतीक्षा करें और पुनः प्रयास करें, या उच्च थ्रूपुट बनाए रखने के लिए अपने प्रीपेड क्रेडिट टायर को अपग्रेड करें।
क्या मॉडल मेरे डेटा पर प्रशिक्षित है?
नहीं। API को भेजे गए प्रॉम्प्ट प्रशिक्षण के लिए उपयोग नहीं किए जाते हैं। आपका डेटा निजी रहता है और बेस मॉडल को बेहतर बनाने के लिए उपयोग नहीं किया जाता है।
आपकी कुंजी बस एक फ़ॉर्म दूर है
एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।
तकनीकी विवरण
API की सभी असली सीमाएँ और सुविधाएँ एक जगह — क्रेडिट जोड़ने से पहले इन्हें देख लें।
| मद | मान |
|---|---|
| API फ़ॉर्मेट | OpenAI के अनुकूल: कोई भी OpenAI SDK चलेगा — बस base URL और कुंजी बदलें |
| मॉडल ID | uncensored |
| प्रमाणीकरण | Authorization: Bearer YOUR_KEY |
| एंडपॉइंट | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| अधिकतम आउटपुट | 100,000-टोकन विंडो के शेष हिस्से तक; max_tokens वैकल्पिक (अलग सीमा नहीं) |
| पैरामीटर | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| फ़ंक्शन कॉलिंग | हाँ — tools, tool_choice; जवाब में tool_calls, स्ट्रीमिंग में भी; नतीजे role: tool संदेश से भेजें |
| स्ट्रीमिंग | हाँ — server-sent events; आख़िरी हिस्से में टोकन उपयोग |
| कॉन्टेक्स्ट विंडो | 100,000 टोकन (इनपुट + आउटपुट मिलाकर) |
| JSON मोड | response_format: {"type": "json_object"} |
| समानांतर अनुरोध | प्रति कुंजी एक साथ 8 तक |
| रेट लिमिट | प्रति कुंजी प्रति मिनट 300 अनुरोध |
| रिस्पॉन्स हेडर | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| अनुरोध का आकार | 8 MB तक |
| कीमत | प्रति 10 लाख इनपुट टोकन $0.15 · प्रति 10 लाख आउटपुट टोकन $0.50 |
| बिलिंग | प्रीपेड क्रेडिट, असली उपयोग के अनुसार; त्रुटियाँ और अस्वीकृतियाँ मुफ़्त |
| बोनस | $50 से +5%, $100 से +10%, $200 से +15% |
| वैधता | भुगतान किया क्रेडिट कभी समाप्त नहीं होता, कोई सदस्यता नहीं |
| टॉप-अप | USDT (TRC20) या USDC (Base), $20 से $500 तक कोई भी पूरी राशि |
| मुफ़्त ट्रायल क्रेडिट | $0.50, 7 दिन, कार्ड की ज़रूरत नहीं · ट्रायल कुंजी: 2 समानांतर अनुरोध, 60 प्रति मिनट; पहले टॉप-अप के बाद पूरी सीमाएँ (8 और 300) |
| कुंजियाँ | हर खाते में एक सक्रिय कुंजी; नई कुंजी पुरानी की जगह लेती है |
| साइन इन | Google या ईमेल और पासवर्ड |
| सामग्री | वयस्क सामग्री की अनुमति; नाबालिगों से जुड़ी यौन सामग्री अस्वीकार |
त्रुटि कोड
त्रुटियाँ JSON में स्थिर type के साथ आती हैं; विफल या अस्वीकृत अनुरोधों का शुल्क नहीं लगता।
| कोड | प्रकार | अर्थ |
|---|---|---|
400 | bad_request | अमान्य JSON, खाली संदेश, गलत पैरामीटर या कॉन्टेक्स्ट विंडो से अधिक |
401 | missing_key · invalid_key · key_revoked | कुंजी नहीं, गलत कुंजी या नई कुंजी से बदली गई |
402 | no_credit | क्रेडिट ख़त्म — टॉप-अप करें, तुरंत चालू |
403 | content_blocked | नाबालिगों से जुड़ी यौन सामग्री — अस्वीकार, कोई शुल्क नहीं |
404 | not_found | अज्ञात एंडपॉइंट |
413 | request_too_large | बॉडी 8 MB से बड़ी |
429 | rate_limited · concurrency | 300/मिनट या 8 समानांतर से अधिक — रुककर फिर कोशिश करें |
503 | upstream_busy | मॉडल व्यस्त — कुछ सेकंड बाद फिर कोशिश करें |