मुख्य बिंदु
- हमारा बेस URL https://api.uncensoredgptapi.com/v1 है और मॉडल ID
uncensoredहै। - Python और Node SDKs base_url या baseURL लेते हैं; दोनों ही एन्वायरमेंट वेरिएबल्स को भी पढ़ते हैं।
- अधिकांश विफलताएँ एक गायब /v1, एक दोहराए गए पथ (path), या एक पुराने मॉडल नाम से आती हैं।
- GET /v1/models URL और कुंजी सही हैं, यह पुष्टि करने का सबसे तेज़ तरीका है।
बेस URL क्या करता है
gpt api base_url वह पता है जो एक OpenAI SDK हर एंडपॉइंट पथ से पहले जोड़ता है। डिफ़ॉल्ट रूप से आधिकारिक SDK अनुरोध OpenAI के सर्वरों पर भेजते हैं। यदि आप एक अलग बेस URL सेट करते हैं, तो वही क्लाइंट कोड समान अनुरोध फॉर्मेट किसी अन्य सर्वर पर भेजता है जो समान प्रोटोकॉल का उपयोग करता है।
व्यावहारिक रूप से यही OpenAI-संगत का अर्थ है। हमारा API POST /v1/chat/completions और GET /v1/models को समान JSON संरचनाओं, समान Authorization: Bearer हेडर और समान स्ट्रीमिंग फॉर्मेट स्वीकार करता है। इसलिए आपको तीन मान बदलने होते हैं:
- बेस URL:
https://api.uncensoredgptapi.com/v1 - API कुंजी: आपके डैशबोर्ड से प्राप्त कुंजी
- मॉडल:
uncensored
हमारी सेवा एक स्वतंत्र सेवा है जो एकल ओपन-वेट मॉडल चलाती है। यह OpenAI का API नहीं है और न ही अन्य विक्रेताओं के लिए एक रूटर है, इसलिए gpt-4o जैसे मॉडल नाम यहाँ मौजूद नहीं हैं। हर जगह uncensored का उपयोग करें।
OpenAI SDK के साथ Python
वर्तमान Python SDK में, क्लाइंट बनाते समय base_url पास करें।
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredgptapi.com/v1",
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a base URL is in two sentences."},
],
)
print(resp.choices[0].message.content)यदि आपका कोड पुराना है और openai.api_base का उपयोग करता है, तो यह 1.0 से पहले के SDK पर है, जहाँ वैश्विक सेटिंग का नाम अलग है। पैकेज को अपग्रेड करना अनुकूलित करने से आमतौर पर आसान होता है। pip show openai के साथ संस्करण जाँचें।
SDK अनुरोध कैसे बनाता है, यह जानना मददगार है। यह आपके बेस URL को लेता है, एंडपॉइंट पथ जैसे /chat/completions को जोड़ता है, और आपकी कुंजी से Authorization: Bearer हेडर जोड़ता है। यही पूरी प्रक्रिया है। जब कुछ विफल होता है, तो अंतिम URL को प्रिंट या लॉग करें, और अगले अनुभाग में curl कमांड से तुलना करें।
वही क्लाइंट timeout और max_retries सेटिंग्स स्वीकार करता है। डिफ़ॉल्ट सेटिंग्स कनेक्शन समस्याओं पर कुछ बार पुनः प्रयास करते हैं, जो अधिकांश स्क्रिप्टों के लिए ठीक है। रेट लिमिट के लिए, SDK के रेट लिमिट अपवाद को पकड़ें और बैक ऑफ़ करें। एक स्ट्रीमिंग अनुरोध अंत तक अपना कॉन्करेंसी स्लॉट रोके रखता है, इसलिए लंबी स्ट्रीम की बर्स्ट कॉन्करेंसी लिमिट को छू सकती है भले ही प्रति मिनट आपके अनुरोधों की संख्या कम हो।
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY", max_retries=0)
def ask(text, tries=4):
for attempt in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": text}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")पहली रिट्राई पर पाँच सेकंड का इंतज़ार API द्वारा अस्थायी ओवरलोड पर भेजे गए Retry-After: 5 मान से मेल खाती है। प्रत्येक बाद के प्रयास पर अधिक इंतज़ार करने से एंडपॉइंट पर ज़ोर डालने से बचा जाता है।
Node और curl
Node SDK baseURL का उपयोग करता है, जिसमें URL बड़े अक्षरों में लिखा जाता है।
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredgptapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);किसी भी SDK के बिना, curl बिल्कुल वही दिखाता है जो SDK करता है। पूर्ण URL बेस URL प्लस /chat/completions है।
curl https://api.uncensoredgptapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'उस कमांड को पढ़ना बेस URL को समझने का सबसे स्पष्ट तरीका है: /v1 तक, उसे मिलाकर, सब कुछ बेस है, और SDK शेष भाग जोड़ता है।
एन्वायरमेंट वेरिएबल्स
यदि आप कोड नहीं बदल सकते, या यदि आप कई स्क्रिप्ट्स के लिए एक सेटिंग चाहते हैं, तो OpenAI SDKs OPENAI_BASE_URL और OPENAI_API_KEY को एन्वायरमेंट से पढ़ते हैं जब कोई स्पष्ट मान नहीं दिया जाता है।
export OPENAI_BASE_URL="https://api.uncensoredgptapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python my_script.pyयह उन टूल्स के लिए उपयोगी है जिन्हें आपने नहीं लिखा है। OpenAI SDK पर बनाया गया कुछ भी बदलाव के बिना वेरिएबल्स को चुन सकता है, हालाँकि आपको टूल के अंदर मॉडल नाम uncensored पर सेट करने की आवश्यकता होगी। यदि टूल मॉडल को हार्ड-कोड करता है, तो आपको अपनी सेटिंग या कोड बदलाव की आवश्यकता होगी।
दो एंडपॉइंट्स को अलग रखना
अधिकतर प्रोजेक्ट्स एक एंडपॉइंट पर टेस्ट करते हैं और दूसरे पर शिप करते हैं, या एन्वायरमेंट के बीच स्विच करते हैं। तीन मानों को अपने कोड से बाहर रखें और कॉन्फ़िगरेशन से उन्हें पढ़ें, ताकि स्विच एक फ़ाइल में बदलाव हो, न कि कोड में।
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ.get("LLM_BASE_URL", "https://api.uncensoredgptapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.environ.get("LLM_MODEL", "uncensored")SDK के डिफ़ॉल्ट नामों की जगह अपने खुद के वेरिएबल नाम इस्तेमाल करने से एक छिपा हुआ जाल टल जाता है: एक टूल जो OPENAI_API_KEY से शेल में पढ़ता है, वही कुंजी भेज देगा जो वहां सेट है, चाहे अगला बेस URL कुछ भी हो। यदि आपके प्रोफ़ाइल में एक पुरानी OpenAI कुंजी है और प्रोजेक्ट में एक नया बेस URL, तो आप एक सेवा की कुंजी दूसरी को भेज सकते हैं। अलग नामों से यह असंभव हो जाता है, और आप एक नज़र में देख सकते हैं कि स्क्रिप्ट किस एंडपॉइंट का उपयोग करेगी।
मॉडल नाम को कॉन्फ़िगरेशन के रूप में भी मानें। यह वह मान है जो स्विच करते समय सबसे अक्सर छूट जाता है, और यह सबसे भ्रमित करने वाली विफलताएं पैदा करता है, क्योंकि बाकी सब कुछ सही दिखता है।
स्ट्रीमिंग और टूल्स एक ही बेस URL का उपयोग करते हैं
बेस URL बदलने से फीचर्स सीमित नहीं होते। स्ट्रीमिंग, फ़ंक्शन कॉलिंग और JSON मोड समान /chat/completions पथ से गुजरते हैं, इसलिए मूल API के खिलाफ काम करने वाला कोड काम करता रहता है। स्ट्रीमिंग सर्वर-सेंट इवेंट्स लौटाता है, और उपयोग (usage) की जानकारी स्ट्रीम के अंत में दी जाती है।
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Count from one to five."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
print()chunk.choices पर गार्ड मायने रखता है। अंतिम चंक जिसमें उपयोग होता है, उसमें कोई चॉइस नहीं हो सकता है, और खाली सूची में इंडेक्स करने वाला कोड आखिरी संदेश पर क्रैश कर सकता है। टूल कॉलिंग भी उसी तरह स्ट्रीम होती है, आंशिक tool_calls डेल्टा के रूप में, जिसे फ़ंक्शन चलाने से पहले आप एकत्र करते हैं, और परिणाम role: "tool" वाले संदेशों के रूप में वापस आते हैं। JSON मोड response_format={"type": "json_object"} लेता है।
बेस URL फ़ील्ड वाले ऐप्स और फ्रेमवर्क्स
बहुत से ऐप्स उसी सेटिंग को अलग-अलग नामों से दिखाते हैं: API बेस, एंडपॉइंट, कस्टम OpenAI URL, या होस्ट। नियम वही रहता है। बेस URL को /v1 सहित पेस्ट करें, कुंजी पेस्ट करें, और मॉडल के नाम के रूप में uncensored टाइप करें।
SillyTavern, उदाहरण के लिए, आपको एक OpenAI-संगत एंडपॉइंट जोड़ने की अनुमति देता है। LangChain की ChatOpenAI क्लास एक base_url आर्गुमेंट स्वीकार करती है। अन्य फ्रंट-एंड्स इस फील्ड को प्रॉक्सी URL या रिवर्स प्रॉक्सी कहते हैं। फील्ड नाम संस्करण के अनुसार भिन्न होते हैं, इसलिए उस फील्ड को खोजें जो एक URL लेता है जो /v1 पर समाप्त होता है।
कुछ ऐप्स एक ड्रॉपडाउन से मॉडल मांगते हैं जिसे वे GET /v1/models कॉल करके भरते हैं। वह एंडपॉइंट यहाँ काम करता है और मॉडल सूची लौटाता है, इसलिए ड्रॉपडाउन को URL और कुंजी सही होने पर uncensored दिखाना चाहिए। यदि यह खाली रहता है, तो URL या कुंजी गलत है।
जब कोई ऐप बेस URL फ़ील्ड और "organization" या "project" फ़ील्ड दोनों प्रदान करता है, तो अतिरिक्त फ़ील्ड्स खाली छोड़ दें। वे मूल सेवा के लिए मौजूद हैं और यहाँ कोई मतलब नहीं रखते। यदि कोई ऐप एक ऐसे प्रीफ़िक्स वाली कुंजी पर ज़िद करता है, तो मूल सेवा के लिए प्रीसेट के बजाय एक सामान्य या कस्टम OpenAI-संगत विकल्प जैसे अलग कनेक्शन टाइप आज़माएं।
कुछ डेस्कटॉप टूल्स मूल प्रदाता से एक विशिष्ट मॉडल नाम मांगकर कनेक्शन की जाँच करते हैं, और एंडपॉइंट ठीक होने पर भी विफलता की रिपोर्ट करते हैं। उस स्थिति में, टेस्ट बटन छोड़ दें और एक वास्तविक संदेश भेजें। यदि जवाब आता है, तो URL, कुंजी और मॉडल सही हैं, और टूल केवल अपनी जाँच में कठोर है।
ब्राउज़र-आधारित टूल्स क्रॉस-ओरिजिन नियमों में भी फंस सकते हैं, क्योंकि अनुरोध पेज से निकलकर एक अलग होस्ट पर जाता है। यदि एक वेब टूल ब्राउज़र में विफल हो जाता है लेकिन वही कॉल curl में काम करती है, तो अपने खुद के छोटे सर्वर से अनुरोध चलाएं ताकि कुंजी क्लाइंट-साइड कोड से बाहर रहे, जो किसी भी स्थिति में सुरक्षित डिज़ाइन है।
सामान्य गलतियाँ और उन्हें ठीक करना
लगभग हर विफल सेटअप एक छोटी सूची से आता है।
- /v1 की कमी। बेस URL
https://api.uncensoredgptapi.com/v1है, पूरा पता/v1तक और केवल होस्ट नाम नहीं।/v1के बिना SDK ऐसे पथ बनाता है जो मौजूद नहीं हैं। - दोहरा पथ। यदि आप
.../v1/chat/completionsको बेस URL के रूप में पेस्ट करते हैं, तो SDK पथ को फिर से जोड़ देता है। केवल बेस दें। - ट्रेलिंग स्लैश। अधिकांश SDK इसे हैंडल करते हैं, लेकिन कुछ टूल्स नहीं करते। उसके बिना कोशिश करें।
- पुराना मॉडल नाम। मूल कोड से बचा हुआ
gpt-4oजैसा मॉडल नाम मेल नहीं खाएगा।uncensoredसेट करें। - गलत कुंजी। इस सेवा की कुंजी का उपयोग करें। OpenAI की कुंजी यहाँ काम नहीं करती, और हमारी कुंजी OpenAI पर काम नहीं करती।
- रेट लिमिट त्रुटियाँ। HTTP 429 कोड
rate_limitedका अर्थ है प्रति मिनट बहुत अधिक अनुरोध; कोडconcurrencyका अर्थ है एक साथ बहुत अधिक अनुरोध।Retry-After: 5हेडर के साथ 429 अस्थायी ओवरलोड को दर्शाता है, इसलिए पाँच सेकंड प्रतीक्षा करें और पुनः प्रयास करें।
हमारा त्रुटि निवारण गाइड एकीकरण त्रुटियों को अधिक विस्तार से समझाता है।
एक कॉल में सेटअप की पुष्टि करें
अपने पूरे ऐप को चलाने से पहले, मॉडल्स एंडपॉइंट को कॉल करें। यह सस्ता है और URL और कुंजी दोनों की पुष्टि करता है।
curl https://api.uncensoredgptapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"यदि यह uncensored वाली एक सूची लौटाता है, तो एक वास्तविक चैट अनुरोध भेजें। एक पूर्ण कुंजी के लिए, एक साथ 8 अनुरोध और प्रति मिनट 300 अनुरोध की उम्मीद करें; एक ट्रायल कुंजी 2 एक साथ और प्रति मिनट 60 की अनुमति देती है। प्रत्येक प्रतिक्रिया में X-Request-Id, X-Balance-USD और रेट लिमिट हेडर शामिल होते हैं, जो डिबगिंग के दौरान उपयोगी होते हैं।
कुंजी प्राप्त करने के लिए, साइन अप करें और API कुंजी पृष्ठ का उपयोग करें, जहाँ नए उपयोगकर्ता एक क्लिक के साथ $0.50 का मुफ़्त ट्रायल क्रेडिट प्राप्त कर सकते हैं। दस्तावेज़ कनेक्शन काम करने के बाद स्ट्रीमिंग, फ़ंक्शन कॉलिंग और JSON मोड को कवर करते हैं।
