Kimicode: पांच मिनट में पहला अनुरोध

बेस URL और प्रमाणीकरण

अपने क्लाइंट को हमारे बेस URL https://api.kimicode.top/v1 पर पॉइंट करने से शुरू करें। हर अनुरोध के लिए आपको एक API कुंजी की आवश्यकता है। साइट पर Get API key पर क्लिक करके एक जनरेट करें। Google साइन-इन या ईमेल और पासवर्ड का उपयोग करें। फ़ोन नंबर की आवश्यकता नहीं है। कुंजी तुरंत बनने के बाद दिखाई जाती है। इसे सुरक्षित रखें; एक खाते के लिए एक सक्रिय कुंजी होती है। यदि आप एक नई कुंजी जनरेट करते हैं, तो पुरानी कुंजी काम करना बंद कर देती है। कुंजी को Authorization हेडर में बेयरर टोकन के रूप में पास करें।

पहला अनुरोध

चैट कंप्लीशंस एंडपॉइंट पर अपना पहला प्रॉम्प्ट भेजें। मॉडल ID uncensored का उपयोग करें। API मानक OpenAI-कम्पैटिबल फॉर्मेट्स को स्वीकार करता है। इनपुट जाता है, आउटपुट टेक्स्ट आता है। त्रुटियां और रिफ्यूजल फ्री हैं, इसलिए आप केवल सफल टोकन उपयोग के लिए भुगतान करते हैं। एक सरल प्रॉम्प्ट के साथ कनेक्टिविटी का परीक्षण करें।

कॉपी करेंcurl https://api.kimicode.top/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."}]
  }'

यदि कुंजी अमान्य है, तो आपको 401 त्रुटि मिलती है। यदि आपके पास क्रेडिट नहीं है, तो आपको 402 मिलता है। यदि अनुरोध अप्रत्याशित रूप से विफल होते हैं, तो अपने खाता बैलेंस की जांच करें।

Python SDK एकीकरण

आधिकारिक ओपनएआई Python SDK का उपयोग करें। बेस URL को हमारे एंडपॉइंट पर सेट करें। अपनी API कुंजी पास करें। क्लाइंट अनुरोध प्रारूप को स्वचालित रूप से संभालता है। यह किसी भी भाषा के लिए काम करता है जो ओपनएआई-संगत क्लाइंट का समर्थन करता है। लाइब्रेरी को pip के माध्यम से इंस्टॉल करें। अपनी बेस URL और कुंजी के साथ क्लाइंट कॉन्फ़िगर करें। चैट पूर्णता एंडपॉइंट का उपयोग करके संदेश भेजें। प्रतिक्रिया में जनरेटेड टेक्स्ट होता है। आप प्रतिक्रिया ऑब्जेक्ट से सीधे सामग्री को पार्स कर सकते हैं।

कॉपी करेंfrom openai import OpenAI

client = OpenAI(base_url="https://api.kimicode.top/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 SDK उपयोग

Node.js SDK समान रूप से काम करता है। क्लाइंट आयात करें। बेस URL और API कुंजी कॉन्फ़िगर करें। चैट पूर्णता विधि कॉल करें। मॉडल आईडी और संदेश सरणी पास करें। प्रतिक्रिया संरचना ओपनएआई प्रारूप से मेल खाती है। सहायक संदेश सामग्री निकालें। यह दृष्टिकोण सर्वर-साइड जनरेशन या एज फंक्शंस के लिए काम करता है। बेस URL बदलाव के अलावा कोई अतिरिक्त कॉन्फ़िगरेशन आवश्यक नहीं है।

कॉपी करेंimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kimicode.top/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);

स्टेटस कोड जांचकर त्रुटियों को संभालें। रेट लिमिट 429 लौटाते हैं। अपर्याप्त फंड्स 402 लौटाते हैं।

स्ट्रीमिंग प्रतिक्रियाएं

stream: true सेट करके स्ट्रीमिंग सक्षम करें। API Server-Sent Events (SSE) लौटाता है। प्रत्येक चंक आंशिक सामग्री रखता है। टोकन उपयोग विवरण अंतिम चंक में दिखाई देते हैं। यह लंबे आउटपुट के लिए प्रतीत होने वाली लेटेंसी को कम करता है। स्ट्रीम टर्मिनेशन का सही तरीके से प्रबंधन करें। जब स्ट्रीम समाप्त हो जाए या कोई त्रुटि हो जाए तो कनेक्शन बंद करें। स्ट्रीमिंग उन सभी मानक क्लाइंट्स के साथ काम करता है जो SSE का समर्थन करते हैं।

कॉपी करें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)

सुनिश्चित करें कि आपका क्लाइंट चंक को सही तरीके से बफर करता है। अंतिम प्रतिक्रिया बनाने के लिए सामग्री को संयोजित करें।

सीमाएं, त्रुटियां और कॉन्टेक्स्ट

कॉन्टेक्स्ट विंडो कुल मिलाकर 100,000 टोकन है। हर अनुरोध के लिए मैक्स आउटपुट 32,000 टोकन है। यदि max_tokens सेट नहीं है तो 2,048 सेट करें। रेट लिमिट प्रति कुंजी प्रति मिनट 300 अनुरोध है। कॉन्करेंसी लिमिट 8 समानांतर अनुरोध है। अनुरोध बॉडी मैक्स 8 MB है। त्रुटियों में अमान्य कुंजियों के लिए 401, क्रेडिट न होने के लिए 402 और रेट लिमिट्स के लिए 429 शामिल हैं। क्रेडिट कभी समाप्त नहीं होता। त्रुटियां मुफ़्त हैं। सब्सक्रिप्शन ट्रैप नहीं।