OpenRouter NSFW उपयोगकर्ताओं के लिए शुरुआत

बेस यूआरएल और प्रमाणीकरण

अपने वर्तमान प्रदाता की बेस URL को https://api.openrouternsfw.com/v1 से बदलें। प्रमाणीकरण मानक Authorization: Bearer <key> हेडर का उपयोग करता है। आप API कुंजी प्राप्त करें पेज पर Google या ईमेल के माध्यम से साइन अप करने के तुरंत बाद अपनी कुंजी प्राप्त करते हैं। फ़ोन नंबर की आवश्यकता नहीं है, और कुंजी केवल एक बार प्रदर्शित होती है, इसलिए पेज छोड़ने से पहले इसे कॉपी करें।

हमारी सेवा एक स्वतंत्र एपीआई है, अन्य विक्रेताओं के मॉडल का रीसेलर नहीं। अनुरोधों में भेजा जाने वाला मॉडल पहचानकर्ता uncensored है, जो हमारे अपने सर्वर पर चलता है। इसे कानूनी वयस्क उपयोग के लिए सामग्री अस्वीकृति के बिना उत्तर देने के लिए ट्यून्ड किया गया है, लेकिन यह जीपीटी, क्लॉड या कोई अन्य नामित विक्रेता मॉडल नहीं है।

सुनिश्चित करें कि आपका क्लाइंट लाइब्रेरी इस नए बेस URL का उपयोग करने के लिए कॉन्फ़िगर है। सभी अनुरोधों में हेडर में एक मान्य API कुंजी शामिल होनी चाहिए। यदि कुंजी गायब है या अमान्य है, तो सर्वर 401 त्रुटि लौटाता है। यदि आपके पास कोई प्रीपेड क्रेडिट नहीं है, तो आपको 402 त्रुटि मिलती है। ये मानक HTTP स्थिति कोड हैं जो प्रमाणीकरण या भुगतान की समस्याओं को दर्शाते हैं, सर्वर त्रुटियाँ नहीं।

चैट पूर्णता एंडपॉइंट

मुख्य कार्यक्षमता POST /v1/chat/completions एंडपॉइंट के माध्यम से प्रदान की जाती है। यह एंडपॉइंट मॉडल नाम, संदेश सरणी और वैकल्पिक पैरामीटर वाले JSON बॉडी स्वीकार करता है। यह उत्पन्न पाठ, टोकन उपयोग आँकड़ों और समाप्ति कारण के साथ एक JSON ऑब्जेक्ट लौटाता है। यह संरचना आधिकारिक OpenAI SDKs और अधिकांश OpenAI-संगत क्लाइंट लाइब्रेरी के साथ संगत है।

यदि आप SDK का उपयोग करना पसंद करते हैं, तो आपको कस्टम HTTP क्लाइंट लिखने की आवश्यकता नहीं है। हालाँकि, आपको कॉन्फ़िगरेशन को अपने बेस URL की ओर इशारा करने के लिए अपडेट करना होगा। निम्नलिखित उदाहरन cURL का उपयोग करके एक मानक पूर्णता अनुरोध प्रदर्शित करता है। यह अनुरोध एक प्रॉम्प्ट को बिना सेंसर मॉडल में भेजता है और एक पाठ प्रतिक्रिया की उम्मीद करता है।

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

याद रखें कि यह API केवल पाठ की सेवा करता है। कोई एम्बेडिंग, छवि, ऑडियो या वीडियो जनरेशन एंडपॉइंट नहीं हैं। यदि आपकी एप्लिकेशन को मल्टीमोडल इनपुट या आउटपुट की आवश्यकता है, तो आपको उन्हें अलग से संभालना होगा। हमारी सेवा विशेष रूप से उच्च-गुणवत्ता वाले पाठ जनरेशन पर केंद्रित है जिसमें एक बिना सेंसर मॉडल है।

Python SDK इंटीग्रेशन

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

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

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

यह कोड स्निपेट दिखाता है कि संदेश कैसे भेजें और प्रतिक्रिया कैसे प्राप्त करें। क्लाइंट स्वचालित रूप से कनेक्शन और त्रुटि रिपोर्टिंग संभालता है। यदि सर्वर एक त्रुटि लौटाता है, तो SDK एक अपवाद उठाता है। आपको बेहतर उपयोगकर्ता अनुभव प्रदान करने के लिए अपनी एप्लिकेशन लॉजिक में इन अपवादों को संभालना चाहिए।

Python SDK केवल एक विकल्प है। आप किसी भी भाषा का उपयोग कर सकते हैं जो HTTP अनुरोधों का समर्थन करती है। एंडपॉइंट संरचना आपके द्वारा चुने गए क्लाइंट से स्वतंत्र समान रहती है। यह लचीलापन आपको बिना सेंसर मॉडल को किसी भी मौजूदा वर्कफ़्लो में महत्वपूर्ण कोड परिवर्तनों के बिना एकीकृत करने की अनुमति देता है।

Node SDK उपयोग

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

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

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

Node.js डेवलपर आसानी से इस API को अपनी मौजूदा परियोजनाओं में एकीकृत कर सकते हैं। SDK JSON डेटा के सीरियलाइज़ेशन और डीसीरियलाइज़ेशन को संभालता है। आप आउटपुट की यादृच्छिकता को नियंत्रित करने के लिए temperature या top_p जैसे अतिरिक्त पैरामीटर भी निर्दिष्ट कर सकते हैं।

सुनिश्चित करें कि अनुरोधों की असिंक्रोनस प्रकृति का उचित प्रबंधन किया जाए। प्रतिक्रिया डेटा को प्रबंधित करने के लिए async/await या प्रॉमिस चेन का उपयोग करें। इससे आपकी एप्लिकेशन प्रतिक्रियाशील बनी रहती है जबकि मॉडल पाठ जनरेट करने की प्रतीक्षा कर रहा होता है। नोड एसडीके स्केलेबल टेक्स्ट जनरेशन सेवाएं बनाने के लिए एक विश्वसनीय विकल्प है।

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

अपने अनुरोध में stream पैरामीटर को true पर सेट करके स्ट्रीमिंग सक्षम करें। सर्वर एकल JSON प्रतिक्रिया के बजाय सर्वर-संभाले गए घटनाओं (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)

स्ट्रीमिंग उन रीयल-टाइम एप्लिकेशन के लिए उपयोगी है जहाँ आप आउटपुट को जनरेट होते ही दिखाना चाहते हैं। स्ट्रीम का अंतिम चंक अनुरोध के लिए कुल टोकन उपयोग शामिल करता है। इससे आपको पूरे प्रतिक्रिया को पूरा होने का इंतज़ार किए बिना लागत को सटीक रूप से ट्रैक करने की अनुमति मिलती है।

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

रेट लिमिट और कॉन्टेक्स्ट विंडो

प्रत्येक API कुंजी प्रति मिनट 300 अनुरोधों और 8 समानांतर अनुरोधों तक सीमित है। अनुरोध बॉडी का आकार 8 MB तक सीमित है। यदि आप इन सीमाओं को पार करते हैं, तो सर्वर 429 स्थिति कोड लौटाता है। यह एक मानक HTTP स्थिति कोड है जो संकेत देता है कि आपने एक दिए गए समय विंडो में बहुत सारे अनुरोध भेज दिए हैं। आपको इन त्रुटियों को सहजता से संभालने के लिए अपने क्लाइंट में एक्सपोनेंशियल बैकऑफ़ लागू करना चाहिए।

कॉन्टेक्स्ट विंडो संयुक्त प्रॉम्प्ट और पूर्णता के लिए 100,000 टोकन तक समर्थित करता है। कोई अलग आउटपुट कैप नहीं है। यदि आप max_tokens पैरामीटर निर्दिष्ट नहीं करते हैं, तो प्रतिक्रिया विंडो के अंत तक चल सकती है। आप max_tokens को एक निम्न मान पर सेट करके आउटपुट लंबाई को सीमित कर सकते हैं।

अपने प्रीपेड क्रेडिट का प्रभावी प्रबंधन करने के लिए अपने टोकन उपयोग की निगरानी करें। त्रुटियाँ और रिफ्यूज़ल टोकन खपत नहीं करते हैं, इसलिए विफल अनुरोधों के लिए आपको शुल्क नहीं लगाया जाता है। यह सुनिश्चित करता है कि आप केवल सफल टेक्स्ट जनरेशन के लिए भुगतान करें। अपनी सेवा में किसी भी विघ्न से बचने के लिए अपने रेट लिमिट पर नज़र रखें।