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

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

हमारा API मानक OpenAI प्रारूप का पालन करता है, जिससे आपकी मौजूदा क्लाइंट कॉन्फ़िगरेशन को बदलना आसान हो जाता है। सभी अनुरोधों के लिए बेस URL https://api.qwenapis.com/v1 है। आपको अपने अनुरोधों को प्रमाणीकृत करने के लिए एक API कुंजी की आवश्यकता होगी। यदि आपने अभी तक एक नहीं बनाया है, तो API कुंजी प्राप्त करें पेज पर जाएं और केवल अपना ईमेल और पासवर्ड उपयोग करके एक कुंजी जनरेट करें। ट्रायल क्रेडिट के साथ शुरू करने के लिए क्रेडिट कार्ड की आवश्यकता नहीं है।

प्रत्येक खाते में एक समय में केवल एक सक्रिय कुंजी की अनुमति है। आप किसी भी समय अपनी कुंजी को पुनः जनरेट कर सकते हैं, जिससे तुरंत पिछली कुंजी रद्द हो जाती है। इससे सुनिश्चित होता है कि यदि आपकी कुंजी खुल जाती है, तो आप बिना मासिक चक्र का इंतज़ार किए तुरंत अपने खाते को सुरक्षित कर सकते हैं। अपनी कुंजी को अपने पर्यावरण चर या सीक्रेट मैनेजर में सुरक्षित रखें।

अपना पहला अनुरोध बनाएं

एक सरल टेक्स्ट कंप्लीशन अनुरोध भेजकर अपनी सेटअप की जाँच करें। निम्नलिखित उदाहरण में uncensored मॉडल को प्रॉम्प्ट भेजने के लिए curl का उपयोग किया गया है। YOUR_API_KEY को पिछले चरण में जनरेट की गई कुंजी से बदलें। मॉडल ID uncensored पर सेट है, जिसे कानूनी वयस्क उपयोग के लिए सामग्री अस्वीकृति के बिना उत्तर देने के लिए ट्यून्ड किया गया है।

Copycurl https://api.qwenapis.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."}]
  }'

यदि सफलता मिलती है, तो आपको जनरेटेड टेक्स्ट वाला एक JSON प्रतिक्रिया प्राप्त होगी। यदि आपको 401 त्रुटि मिलती है, तो जांचें कि आपकी कुंजी सही है या नहीं। एक 402 त्रुटि इंगित करती है कि आपकी प्रीपेड क्रेडिट समाप्त हो गई है।

Python SDK एकीकरण

Python डेवलपर्स के लिए, आधिकारिक OpenAI SDK सीधे हमारे एंडपॉइंट के साथ काम करता है। pip का उपयोग करके लाइब्रेरी इंस्टॉल करें, फिर क्लाइंट को हमारे बेस URL की ओर इशारा करने के लिए कॉन्फ़िगर करें। इससे आपको अपने एप्लिकेशन लॉजिक में महत्वपूर्ण बदलाव किए बिना परिचित विधियों जैसे chat.completions.create() का उपयोग करने की अनुमति मिलती है। SDK आपके लिए JSON serialisation और रीट्राई लॉजिक संभालता है।

Copyfrom openai import OpenAI

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

api_key और base_url को सही से सेट करना न भूलें। मॉडल का नाम uncensored ही रहता है। यह दृष्टिकोण अन्य प्रदाताओं के लिए लिखे गए कोड के साथ संगतता सुनिश्चित करता है, जिससे अलग-अलग एंडपॉइंट्स को बदलना या परीक्षण करना आसान हो जाता है।

Node SDK उपयोग

Node.js डेवलपर्स @anthropic-ai/sdk या आधिकारिक openai npm पैकेज का उपयोग कर सकते हैं। हमारे बेस URL और अपनी API कुंजी के साथ क्लाइंट को कॉन्फ़िगर करें। अनुरोध की संरचना अन्य OpenAI-संगत सेवाओं के समान है। इससे आप न्यूनतम कोड बदलाव के साथ अपने मौजूदा Node.js एप्लिकेशन्स में बिना सेंसर Qwen को एकीकृत कर सकते हैं।

Copyimport OpenAI from "openai";

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

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

स्ट्रीमिंग सक्षम करें

कम लेटेंसी और बेहतर यूजर एक्सपीरियंस के लिए, अपने अनुरोधों में स्ट्रीमिंग सक्षम करें। स्ट्रीमिंग जनरेट होते ही रिस्पॉन्स टोकन-बाय-टोकन भेजता है, जिससे आपकी एप्लिकेशन आउटपुट को प्रगतिशील रूप से प्रदर्शित कर सकती है। अपने अनुरोध में stream पैरामीटर को true पर सेट करें। SDK चंक्स का एक इटरबल स्ट्रीम प्रदान करेगा।

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)

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

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

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