Mukenetsu AI API क्विक स्टार्ट

बेस सेटअप और बेस URL

Mukenetsu AI एक OpenAI-संगत REST API के रूप में डिज़ाइन किया गया है। इससे मौजूदा OpenAI क्लाइंट या SDK को न्यूनतम परिवर्तन के साथ उपयोग किया जा सकता है। API से संचार के लिए निम्नलिखित बेस URL का उपयोग करें।

https://api.mukenetsuapi.com/v1

अन्य LLM सेवाओं के विपरीत, जटिल एंडपॉइंट चयन या अतिरिक्त सेटअप की आवश्यकता नहीं है। केवल एक चैट कंप्लीशन एंडपॉइंट और मॉडल सूची एंडपॉइंट प्रदान किए जाते हैं। इस सरल संरचना के कारण, विकास तेज़ी से होता है।

API कुंजी को तुरंत प्राप्त किया जा सकता है जब आप Get API key पेज पर ईमेल और पासवर्ड का उपयोग करके साइन अप करते हैं। डैशबोर्ड की आवश्यकता नहीं है। साथ ही, गोपनीयता पर ध्यान दिया जाता है, प्रॉम्प्ट डेटा मॉडल ट्रेनिंग के लिए उपयोग नहीं किया जाता है।

प्रमाणीकरण और API कुंजी

API तक पहुँचने के लिए, हेडर Authorization: Bearer <API_KEY> द्वारा प्रमाणीकरण की आवश्यकता होती है। Mukenetsu AI की API कुंजी खाता निर्माण के समय उत्पन्न की गई का उपयोग करें। एक खाते के लिए एक API कुंजी आवंटित की जाती है, जिसे आप आवश्यकतानुसार किसी भी समय पुनः उत्पन्न कर सकते हैं। ध्यान दें कि कुंजी को पुनः उत्पन्न करने पर, उससे पूर्व की कुंजी अमान्य हो जाती है।

प्रमाणीकरण त्रुटि होने पर, आमतौर पर 401 (Unauthorized) या 402 (Payment Required) प्रतिक्रिया लौटाई जाती है। 401 का अर्थ है कि कुंजी गलत या अमान्य है, और 402 का अर्थ है कि खाते में क्रेडिट शेष राशि कम है। क्रेडिट प्रीपेड है, और आप क्रिप्टोकरेंसी (USDT, USDC) से $10 या उससे अधिक से चार्ज कर सकते हैं।

चैट कंप्लीशन एंडपॉइंट

टेक्स्ट जनरेशन का मुख्य एंडपॉइंट POST /v1/chat/completions है। इस एंडपॉइंट पर अनुरोध भेजकर, आप संवाद इतिहास या सिस्टम प्रॉम्प्ट सहित टेक्स्ट जनरेट कर सकते हैं। मॉडल ID के रूप में uncensored निर्दिष्ट करें। यह एक ओपन-वेट मॉडल है जो OpenAI के GPT या अन्य वेंडर के मॉडलों से भिन्न है।

निम्नलिखित उदाहरण curl का उपयोग करके बुनियादी टेक्स्ट जनरेशन करने का तरीका दिखाता है। आवश्यक पैरामीटर मॉडल ID, संदेश, और वैकल्पिक रूप से स्ट्रीमिंग सक्षम करना है।

コピーcurl https://api.mukenetsuapi.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."}]
  }'

इस एंडपॉइंट पर एम्बेडिंग (embeddings), इमेज जनरेशन, या स्पीच ट्रांसफॉर्मेशन जैसी सुविधाएँ प्रदान नहीं की जाती हैं। यह केवल टेक्स्ट कंप्लीशन और जनरेशन के लिए समर्पित है।

स्ट्रीमिंग (SSE)

यदि आप जनरेटेड टेक्स्ट को रियल-टाइम में प्राप्त करना चाहते हैं, तो स्ट्रीमिंग मोड का उपयोग कर सकते हैं। अनुरोध में "stream": true शामिल करने पर, सर्वर डेटा को SSE (Server-Sent Events) फॉर्मेट में क्रमिक रूप से लौटाता है। इससे उपयोगकर्ता जनरेशन पूरा होने से पहले टेक्स्ट का एक हिस्सा प्रदर्शित कर सकते हैं।

यदि आप Python OpenAI SDK या Node.js क्लाइंट लाइब्रेरी का उपयोग कर रहे हैं, तो stream=True विकल्प निर्दिष्ट करने से स्वचालित रूप से स्ट्रीमिंग प्रक्रिया होती है। इवेंट हैंडलर टोकन-प्रति-चंक प्राप्त करता है।

コピーfrom openai import OpenAI

client = OpenAI(base_url="https://api.mukenetsuapi.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)

स्ट्रीमिंग लंबी प्रतिक्रियाओं या इंटरैक्टिव एप्लिकेशन में उपयोगकर्ता अनुभव को बढ़ाने के लिए एक महत्वपूर्ण सुविधा है। हालाँकि, स्ट्रीमिंग के दौरान कनेक्शन टूट जाने पर, आगे के इवेंट प्राप्त नहीं किए जा सकते।

टूल/फ़ंक्शन कॉलिंग

मुकेनेत्सु AI API फ़ंक्शन कॉलिंग का समर्थन करता है। इससे बाहरी API और डेटाबेस के साथ एकीकरण आसान हो जाता है। अनुरोध बॉडी में tools फ़ील्ड और tool_choice पैरामीटर शामिल करके, आप मॉडल को विशिष्ट फ़ंक्शन निष्पादित कर सकते हैं।

मॉडल आवश्यकता के अनुसार फ़ंक्शन को कॉल करता है या सामान्य टेक्स्ट लौटाता है। कॉल पूरा होने पर, फ़ंक्शन के परिणाम को messages में जोड़कर मॉडल को पारित करने से, आप अधिक विस्तृत उत्तर प्राप्त कर सकते हैं।

コピーimport OpenAI from "openai";

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

यह सुविधा एजेंट-आधारित एप्लिकेशन या जटिल कार्यों के स्वचालन के लिए विशेष रूप से उपयोगी है। OpenAI-संगत फॉर्मेट अपनाए जाने के कारण, मौजूदा टूल कॉलिंग लॉजिक को सीधे उपयोग किया जा सकता है।

रेट लिमिट और बाधाएँ

API के उपयोग की निम्नलिखित सीमाएँ हैं: प्रति मिनट अधिकतम 300 अनुरोध, अनुरोध बॉडी का अधिकतम आकार 8 MB है। इनसे अधिक होने पर 429 (Too Many Requests) त्रुटि लौटाई जाती है। कॉन्टेक्स्ट विंडो 100,000 टोकन (प्रॉम्प्ट + जनरेटेड टेक्स्ट का कुल) है। इससे लंबे संवाद या दस्तावेजों को उचित रूप से विभाजित करके भेजना आवश्यक है।

स्ट्रीमिंग प्रतिक्रिया प्राप्त करते समय, निम्नलिखित इवेंट फ्लो का पालन करें।

コピー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)

साथ ही, किशोरों के साथ यौन सामग्री कड़ाई से प्रतिबंधित है। यह कानून के अनुसार संचालन के लिए है। अन्य कानूनी वयस्क सामग्री, फिक्शन, सुरक्षा शोध, या विवादास्पद विषयों पर बिना सेंसर जनरेशन किया जाता है।