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

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

डैशबोर्ड पर अपनी कुंजी जनरेट करें। हमारा बेस URL HTTPS://api.aivenice.cc/v1 है। अपनी कुंजी को Authorization हेडर में पास करें। प्रति खाता एक सक्रिय कुंजी पुरानी कुंजी को स्वचालित रूप से बदल देती है।

पहला अनुरोध उदाहरण

कनेक्टिविटी का परीक्षण करने के लिए एक सरल चैट पूरक भेजें। मॉडल आईडी "uncensored" है। यह पाठ इन और पाठ आउट को कुशलता से संभालता है। आप रचनात्मकता के लिए तापमान जैसे पैरामीटर समायोजित कर सकते हैं।

Copyfrom openai import OpenAI

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

त्रुटियाँ मुफ्त हैं। अस्वीकृतियाँ क्रेडिट खर्च नहीं करतीं। यह आपके पहले कॉल से ही पूर्वानुमेय बिलिंग सुनिश्चित करता है।

Node.js इंटीग्रेशन

आसान इंटीग्रेशन के लिए आधिकारिक Node SDK का उपयोग करें। बेस यूआरएल को हमारे एंडपॉइंट पर सेट करें। कॉन्फ़िगरेशन ऑब्जेक्ट में अपना API की पास करें। यह दृष्टिकोण अधिकांश मानक OpenAI-संगत लाइब्रेरीज़ के साथ काम करता है।

Copyimport OpenAI from "openai";

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

प्रतिक्रियाओं को अपने जावास्क्रिप्ट वातावरण में सीधे हैंडल करें। संरचना परिचितता के लिए मानक OpenAI फॉर्मेट से मेल खाती है।

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

स्ट्रीमिंग को सक्षम करने के लिए stream को true सेट करें। आप उत्पन्न होते ही टोकन प्राप्त करते हैं। यह उपयोगकर्ताओं के लिए अनुभवगत विलंबता को कम करता है। अंतिम चंक में कुल टोकन उपयोग विवरण शामिल होता है।

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)

SSE इवेंट्स को पार्स करें ताकि आपका UI रियल-टाइम अपडेट हो। यह तत्काल प्रतिक्रिया की आवश्यकता वाले चैट इंटरफेस के लिए आदर्श है।

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

नियंत्रण के लिए तापमान (temperature), top_p, और सीड (seed) को एडजस्ट करें। अधिकतम आउटपुट 16,000 टोकन है। कॉन्टेक्स्ट विंडो 100,000 टोकन है। रेट लिमिट प्रति मिनट 300 अनुरोध है। बॉडी साइड अधिकतम 8 MB तक होती है।

ये सीमाएं स्थिर प्रदर्शन को सुनिश्चित करती हैं। दर सीमा को पार करने पर एक 429 त्रुटि लौटाई जाती है। यदि आवश्यक हो तो सह-कार्यक्षमता (concurrency) बढ़ाएं।

त्रुटियां और संदर्भ विंडो

अमान्य कुंजियों के लिए 401 हैंडल करें। क्रेडिट कम होने पर 402 का उपयोग करें। 429 दर सीमा पार होने को दर्शाता है। त्रुटियां और अस्वीकृतियां मुफ्त हैं। आपका पूर्व-भुगतान क्रेडिट कभी समाप्त नहीं होता है। संदर्भ विंडो प्रॉम्प्ट और पूर्णता टोकनों को एक साथ गिनती है।

स्ट्रीमिंग में अंतिम चंक के माध्यम से उपयोग की निगरानी करें। यह आपको बजट के भीतर रहने में मदद करता है। कोई छिपी हुई फीस लागू नहीं होती है।

cURL

Copycurl https://api.aivenice.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the latest error logs from server logs"}]
  }'