API रानी API दस्तावेज़ीकरण

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

प्रमाणीकरण एक मानक Bearer टोकन का उपयोग करता है जो Authorization हेडर। यह दृष्टिकोण मौजूदा OpenAI SDKs के साथ संगतता सुनिश्चित करता है बिना कस्टम लॉजिक की आवश्यकता के। आपका API_KEY Google या ईमेल के माध्यम से साइनअप के तुरंत जनरेट होता है। सभी अनुरोधों को सेवा के लिए प्रदान की गई विशिष्ट बेस URL की ओर इशारा करना चाहिए।

• बेस यूआरएल: https://api.apiqueen.cc/v1
• हेडर: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

/v1/chat/completions पर अनुरोध भेजना

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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

मॉडल पैरामीटर: तापमान, टॉप-P, और स्टॉप

मानक LLM पैरामीटर का उपयोग करके प्रतिक्रिया जनरेशन को नियंत्रित करें। सेट करें temperature 0 और 2 के बीच विविध यादृच्छिकता के लिए। top_p कम संभावित शब्दों को फिल्टर करने के लिए। परिभाषित करें stop सीक्वेंस का उपयोग विशिष्ट ट्रिगर पर आउटपुट रोकने के लिए। ये सेटिंग्स रचनात्मक लेखन या तथ्यात्मक पुनर्प्राप्ति कार्यों के लिए सटीक ट्यूनिंग की अनुमति देती हैं।

API असमर्थित पैरामीटर को सहजता से अनदेखा करती है। फोकस करें temperature, top_p, और stop उत्तम परिणामों के लिए। अपने एप्लिकेशन के शोर सहनशीलता के आधार पर इन मानों को समायोजित करें।

स्ट्रीमिंग रिस्पॉन्सेस और टोकन उपयोग

सेटिंग करके स्ट्रीमिंग सक्षम करें stream: true आपके अनुरोध में। API सर्वर-सेंट इवेंट्स (SSE) के माध्यम से डेटा चंक लौटाता है। टोकन उपयोग विवरण केवल स्ट्रीम के अंतिम चंक में प्रकट होते हैं। इससे आपके UI में प्रतिक्रियाओं का रियल-टाइम रेंडरिंग संभव होता है।

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)

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

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

संरचित डेटा निष्कर्षण के लिए फ़ंक्शन कॉलिंग का उपयोग करें। टूल को अनुरोध में परिभाषित करें। tools पैरामीटर। मॉडल वैध JSON लौटाता है जब response_format सेट है {"type": "json_object"}. डाउनस्ट्रीम एप्लिकेशन में स्थिर पार्सिंग सुनिश्चित करता है।

सेट करें tool_choice विशिष्ट फंक्शन कॉल्स को बल देने के लिए। यह उन स्वचालित वर्कफ्लो के लिए उपयोगी है जिन्हें कठोर आउटपुट फॉर्मेट की आवश्यकता होती है।

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

सामान्य समस्याओं के लिए HTTP स्टेटस कोड्स की निगरानी करें। एक 401 त्रुटि का अर्थ है कि आपकी API कुंई अमान्य है। एक 402 त्रुटि पर्याप्त पूर्व-भुगतान क्रेडिट की कमी को दर्शाती है। त्रुटियां आपके टोकन बैलेंस का उपयोग नहीं करतीं। रेट लिमिट्स प्रति कुंई प्रति मिनट 300 अनुरोधों को लागू करती हैं। समवर्ती अनुरोध 8 तक सीमित हैं। संदर्भ विंडो कुल मिलाकर 100,000 टोकन का समर्थन करती है।

एक्सपोनेंशियल बैकऑफ़ के साथ रीट्राई हैंडल करें। जांचें कि error object JSON रिस्पॉन्स में विवरण के लिए।