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

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

हमारे समर्पित एंडपॉइंट की ओर इशारा करके और अपनी अद्वितीय API कुंजी पास करके अपनी एप्लिकेशन को कनेक्ट करें। सभी अनुरोधों के लिए बेस यूआरएल है https://api.apertusapp.com/v1. आप Google या ईमेल के माध्यम से साइनअप करने के तुरंत बाद अपनी कुंजी प्राप्त करते हैं API कुंजी प्राप्त करें पेज। इस कुंजी को Authorization हर रिक्वेस्ट के लिए हेडर।

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

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

पहला अनुरोध

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusapp.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 मानक पैरामीटर जैसे स्वीकार करता है temperature और top_p. त्रुटियां और अस्वीकृतियां टोकन खपत नहीं करतीं, इसलिए आप केवल उसी के लिए भुगतान करते हैं जो वास्तव में मॉडल तक पहुंचता है। यह दृष्टिकोण एग्रीगेटर्स की तुलना में लागत को भविष्योचित रखता है जो रूटिंग ओवरहेड के लिए शुल्क लेते हैं।

Node SDK एकीकरण

आधिकारिक Node SDK का उपयोग करें ताकि JSON मोड और फंक्शन कॉलिंग को कुशलता से हैंडल किया जा सके। सेट response_format को {"type": "json_object"} एजेंट-जैसे व्यवहार के लिए टूल परिभाषित करने या संरचित आउटपुट के लिए।

Copyimport OpenAI from "openai";

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

मॉडल टूल कॉल का समर्थन करता है tool_choice विकल्प। आप एक भी सेट कर सकते हैं seed निर्धारक परिणामों के लिए। यह लचीलापन आपको OpenAI-संगत पारिस्थितिकी तंत्र से बाहर न जाते हुए जटिल एप्लिकेशन बनाने की अनुमति देता है।

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

कम लेटेंसी वाले यूजर अनुभवों के लिए Server-Sent Events (SSE) का उपयोग करके टोकन को रियल-टाइम में स्ट्रीम करें। प्रत्येक चंक में जनरेटेड टेक्स्ट होता है, और अंतिम चंक में कुल टोकन उपयोग सांख्यिकी शामिल होती है।

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 SSE प्रोटोकॉल को स्वचालित रूप से संभालता है, जिससे आपके पक्ष में न्यूनतम कोड की आवश्यकता होती है।

संदर्भ विंडो और क्षमता

मॉडल इनपुट और आउटपुट दोनों के लिए 100,000-टोकन का कॉन्टेक्स्ट विंडो सपोर्ट करता है। आप प्रति रिक्वेस्ट 16,000 टोकन तक निर्दिष्ट कर सकते हैं, या यदि आप omit करते हैं तो 2,048 टोकन पर वापस आ सकते हैं। max_tokens.

यह बड़ा विंडो व्यापक दस्तावेज़ विश्लेषण या लंबी बातचीत के इतिहास की अनुमति देता है। हालांकि, अनुरोध बॉडी को 8 MB से कम रखें। मॉडल GPT या Llama नहीं है; यह एक अलग अनसेंसर्ड AI मॉडल है जो आपके विशिष्ट उपयोग मामले के लिए अनुकूलित है।

त्रुटि हैंडलिंग और सीमाएँ

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

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