अनकेंसर API इंटिग्रेशन गाइड

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

अपने OpenAI-संगत SDK को समर्पित एंडपॉइंट की ओर इशारा करके शुरू करें। हमारी इंफ्रास्ट्रक्चर सभी अनुरोधों के लिए एकल बेस यूआरएल का उपयोग करती है, यह सुनिश्चित करते हुए कि आप केवल uncensored मॉडल के साथ संपर्क में रहें और वेंडर लॉक-इन से बचें। आपको अपनी API कुंरी Authorization हर कॉल के लिए हेडर। यह कुकी तुरंत जनरेट होती है जब आप Google या ईमेल के माध्यम से साइन अप करते हैं। एक्सेस बनाए रखने के लिए कोई मासिक शुल्क नहीं है, और कुकी तब तक मान्य रहती है जब तक आपकी प्रीपेड क्रेडिट खत्म नहीं हो जाती। प्रमाणीकरण के दौरान त्रुटियां, जैसे कि अमान्य कुकी, 401 स्टेटस कोड लौटाती हैं। कानूनी वयस्क सामग्री के लिए अस्वीकृतियां मुफ्त हैं, लेकिन आप केवल वास्तविक टोकन उपयोग के लिए भुगतान करते हैं।

Copycurl https://api.unsecureapikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the three main dependencies for this python script"}]
  }'

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

टेक्स्ट डेटा को POST /v1/chat/completions जनरेटेड प्रतिक्रियाएँ प्राप्त करने के लिए एंडपॉइंट। यह आपके इंटीग्रेशन के लिए प्राथमिक इंटरफ़ेस है, जो प्रॉम्प्ट और कंप्लीशन दोनों के लिए 100,000 टोकन की कंटैक्स्ट विंडो का समर्थन करता है। आपके पेलोड में निर्दिष्ट करने के लिए मॉडल ID हमेशा uncensored. आपको जटिल मॉडल रूटिंग या वर्जनिंग की चिंता करने की आवश्यकता नहीं है, क्योंकि हम एकल ओपन-वेइट मॉडल सर्व करते हैं जो अनफिल्टर्ड आउटपुट के लिए ट्यून्ड है। यदि आप 8 MB अनुरोध बॉडी सीमा को पार करते हैं, तो API एक त्रुटि लौटाता है। आप उपलब्ध मॉडल्स को भी GET /v1/models भारी लोडिंग से पहले कनेक्टिविटी की पुष्टि करें।

स्ट्रीमिंग रिस्पॉन्सेस

अपने अनुरोध पेलोड में stream: true सेट करके रियल-टाइम टोकन जनरेशन सक्षम करें। API आपके एप्लिकेशन में कम-विलंबता प्रदर्शन के लिए सर्वर-सेंट इवेंट्स (SSE) लौटाता है। टोकन उपयोग के आंकड़े स्ट्रीम के अंतिम चंक में प्रकट होते हैं, जिससे आप लागत को सटीक रूप से ट्रैक कर सकते हैं। यह विधि उन चैटबॉट्स या इंटरैक्टिव इंटरफेस के लिए आदर्श है जहां उपयोगकर्ता तत्काल प्रतिक्रिया की उम्मीद करते हैं। ध्यान दें कि प्रति अनुरोध अधिकतम आउटपुट पूरे 100,000-टोकन विंडो तक हो सकता है; max_tokens वैकल्पिक है। जब बेस URL सही रूप से अपडेट किया जाता है, तो स्ट्रीमिंग मानक OpenAI SDKs के साथ सहज रूप से काम करती है।

Copyfrom openai import OpenAI

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

फंक्शन कॉलिंग & JSON मोड

JSON मोड या फंक्शन कॉलिंग क्षमताओं का उपयोग करके संरचित डेटा आउटपुट इंटीग्रेट करें। सेट करें response_format को {"type": "json_object"} अपने पार्सर के लिए स्थिर JSON आउटपुट को बल देने के लिए। आप टूल परिभाषित कर सकते हैं और निर्दिष्ट कर सकते हैं tool_choice जटिल एजेंट वर्कफ़्लो के लिए। अनसेंसर्ड मॉडल इन सुविधाओं को समर्थन देता है, बिना उन कठोर गार्डरेल्स के जो अक्सर अन्य प्रदाताओं में फ़ंक्शन स्कीमा को तोड़ देते हैं। यह उन स्वचालित पाइपलाइनों के लिए विश्वसनीय है जिन्हें सटीक डेटा एक्सट्रैक्शन की आवश्यकता होती है। क्लाइंट साइड पर पार्सिंग त्रुटियों से बचने के लिए सुनिश्चित करें कि आपके टूल डिफ़िनिशन्स वैध हों।

Copyimport OpenAI from "openai";

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

पैरामीटर & सीमाएं

मानक पैरामीटर जैसे तापमान और top_p का उपयोग करके जनरेशन व्यवहार को नियंत्रित करें। temperature, top_p, stop, और seed. इनसे आपकी आउटपुट में रचनात्मकता और निर्धारितता (determinism) के बीच संतुलन बनाना संभव होता है। प्रति कुंजी (key) प्रति मिनट 300 अनुरोधों की सीमा है, और एक साथ 8 अनुरोधों की सह-संचालन (concurrency) अनुमत है। एक खाते के लिए केवल एक सक्रिय कुंजी अनुमत है; नई कुंजी जनरेट करने से पुरानी कुंजी समाप्त हो जाती है। प्रीपेड क्रेडिट मॉडल का अर्थ है कि आप इनपुट टोकन के प्रति 1M के लिए $0.15 और आउटपुट टोकन के प्रति 1M के लिए $0.50 भुगतान करते हैं। त्रुटियों से क्रेडिट खर्च नहीं होता, जिससे आपको केवल सफल पूर्णताओं के लिए ही भुगतान करना पड़ता है।

त्रुटि हैंडलिंग

स्थिरता बनाए रखने के लिए सामान्य API प्रतिक्रियाओं को सहजता से संभालें। 401 त्रुटि का अर्थ है कि API कुंजी अमान्य या समाप्त हो गई है। 402 त्रुटि का अर्थ है कि आपका पूर्व-भुगतान किया गया बैलेंस अपर्याप्त है, जिसके लिए USDT या USDC के माध्यम से क्रिप्टो टॉप-अप की आवश्यकता है। यदि आप प्रति मिनट 300 अनुरोधों से अधिक करते हैं तो रेट लिमिट ट्रिगर होकर 429 प्रतिक्रिया देता है। API एम्बेडिंग या इमेज डेटा लौटाता नहीं है, इसलिए उन प्रारूपों का अनुरोध करने से त्रुटियां हो सकती हैं। JSON बॉडी को पार्स करने से पहले हमेशा स्टेटस कोड जांचें। कॉन्टेक्स्ट विंडो की सीमाएं कठोर हैं, इसलिए लंबी बातचीत में ट्रंकेशन (truncation) से बचने के लिए टोकन गिनती की निगरानी करें।

Copystream = 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)