Best LLM API दस्तावेज़
क्विकस्टार्ट गाइड: ड्रॉप-इन एकीकरण
अपने मौजूदा OpenAI-संगत कोडबेस में बेस URL और API कुंजी बदलकर अपनी एप्लिकेशन में हमारी अनसेंस्ड LLM API एकीकृत करें।
आवश्यकताएँ
अपना पहला अनुरोध भेजने से पहले, सुनिश्चित करें कि आपके पास एक मान्य API कुंजी है। तुरंत अपनी कुंजी प्राप्त करने के लिए API कुंजी प्राप्त करें पृष्ठ पर साइन अप करें। प्रारंभिक ट्रायल के लिए किसी क्रेडिट कार्ड की आवश्यकता नहीं है। आपको एक समर्थित प्रोग्रामिंग भाषा पर्यावरण (Python 3.8+ या Node.js 18+) और आपके प्रोजेक्ट में इंस्टॉल किया गया आधिकारिक OpenAI SDK की आवश्यकता होगी।
हमारा सेवा मानक चैट-कंप्लीशन एंडपॉइंट्स के लिए एक ड्रॉप-इन रिप्लेसमेंट के रूप में कार्य करता है। आपको एक कस्टम क्लाइंट लाइब्रेरी इंस्टॉल करने की आवश्यकता नहीं है; मानक OpenAI SDK संचार प्रोटोकॉल, जिसमें स्ट्रीमिंग और टूल कॉलिंग शामिल है, को संभालता है, बशर्ते आप बेस URL को सही ढंग से कॉन्फ़िगर करें।
प्रमाणीकरण
प्रमाणीकरण Authorization हेडर के माध्यम से किया जाता है। अपनी API कुंजी को एक Bearer टोकन के रूप में पास करें। यदि कुंजी अमान्य या समाप्त हो जाती है, तो API एक 401 Unauthorized त्रुटि लौटाता है। यदि आपके खाते का शेष पर्याप्त नहीं है, तो आपको एक 402 Payment Required त्रुटि प्राप्त होती है। क्रेडेंशियल्स को हार्डकोड करने से बचने के लिए अपनी कुंजी को अपने एनवायरनमेंट वेरिएबल्स या कॉन्फ़िगरेशन फ़ाइल में जोड़ें।
- हेडर:
Authorization: Bearer YOUR_API_KEY - बेस URL:
https://api.bestllmapi.com/v1
अपनी कुंजी सुरक्षित रखें। आप अपने डैशबोर्ड से किसी भी समय इसे रीजेनरेट कर सकते हैं, जिससे तुरंत पिछली कुंजी अमान्य हो जाती है।
बेसिक चैट कंप्लीशन
/v1/chat/completions पर एक POST अनुरोध भेजें model ID uncensored और अपनी संदेश इतिहास के साथ। API एक टेक्स्ट प्रतिक्रिया लौटाता है। यह एंडपॉइंट मानक OpenAI JSON संरचनाओं का समर्थन करता है, जिससे अन्य प्रदाताओं से माइग्रेशन आसान होता है।
सुनिश्चित करें कि आप system, user, और assistant जैसे भूमिकाओं के साथ संदेशों को सही ढंग से संरचित करें। मॉडल इनपुट को प्रोसेस करता है और आपके प्रॉम्प्ट कॉन्टेक्स्ट के आधार पर एक कम्प्लीशन जनरेट करता है।
curl https://api.bestllmapi.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."}]
}'
स्ट्रीमिंग रिस्पॉन्सेस
रियल-टाइम उपयोगकर्ता अनुभवों के लिए, अपने अनुरोध बॉडी में stream: true सेट करके स्ट्रीमिंग सक्षम करें। API एक सर्वर-सेंट इवेंट्स (SSE) स्ट्रीम लौटाता है जिसमें डेल्टा ऑब्जेक्ट्स होते हैं। प्रत्येक डेल्टा में जनरेटेड टेक्स्ट का एक हिस्सा होता है। अंत-उपयोगकर्ताओं के लिए अनुभूत लेटेंसी कम करने के लिए, टेक्स्ट को जनरेट होते ही प्रदर्शित करने के लिए इन चंक्स को क्रमिक रूप से प्रोसेस करें।
स्ट्रीम हैंडलिंग मानक OpenAI स्ट्रीमिंग प्रोटोकॉल के समान है। आपको यह जानने के लिए कि जनरेशन समाप्त हो गया है, आपको स्ट्रीम कंप्लीशन इवेंट को हैंडल करना होगा।
from openai import OpenAI
client = OpenAI(base_url="https://api.bestllmapi.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)
फ़ंक्शन कॉलिंग
अपने अनुरोध बॉडी में tools पैरामीटर का उपयोग करके फ़ंक्शन परिभाषित करें। मॉडल एक टूल कॉल ऑब्जेक्ट लौटा सकता है। फ़ंक्शन के नाम और तर्कों को पार्स करें, अपने कोड में फ़ंक्शन को निष्पादित करें, और अंतिम प्रतिक्रिया के लिए परिणामों को मॉडल को वापस भेजें। इससे आपका LLM बाहरी APIs या डेटाबेस के साथ गतिशील रूप से इंटरैक्ट कर सकता है।
फ़ंक्शन कॉलिंग मानक OpenAI स्कीमा का पालन करती है। सही टूल चुनने और तर्क निकालने में मॉडल की सटीकता में सुधार करने के लिए सुनिश्चित करें कि आपकी फ़ंक्शन परिभाषाएँ सटीक हों।
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.bestllmapi.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);
कॉन्टेक्स्ट विंडो सीमाएँ
मॉडल 100,000 टोकन की कॉन्टेक्स्ट विंडो का समर्थन करता है, जिसमें प्रॉम्प्ट और कंप्लीशन दोनों टोकन शामिल हैं। इस सीमा से अधिक न जाने के लिए अपने टोकन उपयोग की निगरानी करें, जिससे एक 400 Bad Request त्रुटि आती है। यदि आप प्रति मिनट 300 अनुरोधों की रेट लिमिट पर पहुँच जाते हैं, तो आपको एक 429 Too Many Requests त्रुटि प्राप्त होती है।
रीट्राइज़ के लिए एक्सपोनेंशियल बैकऑफ़ लागू करें। अनुरोध बॉडी 8 MB तक सीमित हैं। लंबी बातचीत के लिए, संदर्भ बनाए रखते हुए टोकन बजट के भीतर रहने के लिए पिछले संदेशों को सारांशित करने पर विचार करें।
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 की सभी असली सीमाएँ और सुविधाएँ एक जगह — क्रेडिट जोड़ने से पहले इन्हें देख लें।
| मद | मान |
|---|---|
| API फ़ॉर्मेट | OpenAI के अनुकूल: कोई भी OpenAI SDK चलेगा — बस base URL और कुंजी बदलें |
| प्रमाणीकरण | Authorization: Bearer YOUR_KEY |
| एंडपॉइंट | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.bestllmapi.com/v1 |
| मॉडल ID | uncensored |
| फ़ंक्शन कॉलिंग | हाँ — tools, tool_choice; जवाब में tool_calls, स्ट्रीमिंग में भी; नतीजे role: tool संदेश से भेजें |
| JSON मोड | response_format: {"type": "json_object"} |
| अधिकतम आउटपुट | 100,000-टोकन विंडो के शेष हिस्से तक; max_tokens वैकल्पिक (अलग सीमा नहीं) |
| कॉन्टेक्स्ट विंडो | 100,000 टोकन (इनपुट + आउटपुट मिलाकर) |
| पैरामीटर | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| स्ट्रीमिंग | हाँ — server-sent events; आख़िरी हिस्से में टोकन उपयोग |
| समानांतर अनुरोध | प्रति कुंजी एक साथ 8 तक |
| रेट लिमिट | प्रति कुंजी प्रति मिनट 300 अनुरोध |
| अनुरोध का आकार | 8 MB तक |
| रिस्पॉन्स हेडर | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| वैधता | भुगतान किया क्रेडिट कभी समाप्त नहीं होता, कोई सदस्यता नहीं |
| बोनस | $50 से +5%, $100 से +10%, $200 से +15% |
| टॉप-अप | USDT (TRC20) या USDC (Base), $20 से $500 तक कोई भी पूरी राशि |
| कीमत | प्रति 10 लाख इनपुट टोकन $0.15 · प्रति 10 लाख आउटपुट टोकन $0.50 |
| बिलिंग | प्रीपेड क्रेडिट, असली उपयोग के अनुसार; त्रुटियाँ और अस्वीकृतियाँ मुफ़्त |
| मुफ़्त ट्रायल क्रेडिट | $0.50, 7 दिन, कार्ड की ज़रूरत नहीं · ट्रायल कुंजी: 2 समानांतर अनुरोध, 60 प्रति मिनट; पहले टॉप-अप के बाद पूरी सीमाएँ (8 और 300) |
| कुंजियाँ | हर खाते में एक सक्रिय कुंजी; नई कुंजी पुरानी की जगह लेती है |
| सामग्री | वयस्क सामग्री की अनुमति; नाबालिगों से जुड़ी यौन सामग्री अस्वीकार |
| साइन इन | Google या ईमेल और पासवर्ड |
त्रुटि कोड
त्रुटियाँ JSON में स्थिर type के साथ आती हैं; विफल या अस्वीकृत अनुरोधों का शुल्क नहीं लगता।
| कोड | प्रकार | अर्थ |
|---|---|---|
400 | bad_request | अमान्य JSON, खाली संदेश, गलत पैरामीटर या कॉन्टेक्स्ट विंडो से अधिक |
401 | missing_key · invalid_key · key_revoked | कुंजी नहीं, गलत कुंजी या नई कुंजी से बदली गई |
402 | no_credit | क्रेडिट ख़त्म — टॉप-अप करें, तुरंत चालू |
403 | content_blocked | नाबालिगों से जुड़ी यौन सामग्री — अस्वीकार, कोई शुल्क नहीं |
404 | not_found | अज्ञात एंडपॉइंट |
413 | request_too_large | बॉडी 8 MB से बड़ी |
429 | rate_limited · concurrency | 300/मिनट या 8 समानांतर से अधिक — रुककर फिर कोशिश करें |
503 | upstream_busy | मॉडल व्यस्त — कुछ सेकंड बाद फिर कोशिश करें |
प्रश्न और उत्तर
क्या यह API आधिकारिक OpenAI SDK के साथ संगत है?
हाँ, यह पूर्णतः संगत है। आपको केवल मौजूदा OpenAI SDK कॉन्फ़िगरेशन में बेस URL और API कुंजी बदलने की आवश्यकता है।
यदि मैं रेट लिमिट से अधिक हो जाता हूँ तो क्या होता है?
API 429 Too Many Requests त्रुटि लौटाता है। आपको इसे प्रभावी ढंग से संभालने के लिए एक्सपोनेंशियल बैकऑफ़ के साथ रीट्राई लॉजिक लागू करना चाहिए।
क्या मैं इस API का उपयोग इमेज जनरेशन के लिए कर सकता हूँ?
नहीं, यह API केवल टेक्स्ट कंप्लीशन प्रदान करता है। इसमें इमेज, ऑडियो या वीडियो जनरेशन एंडपॉइंट्स का समर्थन नहीं है।
आपकी कुंजी बस एक फ़ॉर्म दूर है
एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।