OpenAI-शैली API cURL और Bearer Token के साथ
कमांड लाइन से OpenAI-शैली API कॉल करने के लिए आप एक HTTP POST भेजते हैं जिसमें एक Authorization हेडर होता है जो आपका टोकन ले जाता है। यह पेज इस API के हर फीचर के लिए काम करने वाले cURL कमांड और विफल होने पर चलाने वाले चेक देता है।
अपडेट किया गया

मुख्य बिंदु
- टोकन हेडर Authorization: Bearer YOUR_KEY में जाता है, और मॉडल ID uncensored है।
- दो एंडपॉइंट मौजूद हैं: GET /v1/models और POST /v1/chat/completions।
- टोकन को सर्वर-संदेशित इवेंट्स (SSE) के माध्यम से आते हुए देखने के लिए -N और stream true जोड़ें।
- curl -i के साथ X-Balance-USD और रेट लिमिट हेडर पढ़ें; 429 का मतलब है प्रतीक्षा करें और पुनः प्रयास करें।
न्यूनतम अनुरोध
यह इस सेवा के लिए OpenAI API curl टोकन के साथ करने का सबसे छोटा तरीका है। कुंजी को एक एन्वायरमेंट वेरिएबल में डालें ताकि वह आपकी शेल हिस्ट्री में न जाए, फिर एक चैट संदेश पोस्ट करें:
export UF_KEY="paste-your-key-here"
curl https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what a bearer token is in two sentences."}
]
}'
प्रतिक्रिया JSON में OpenAI चैट पूर्णता आकार में है। उत्तर choices[0].message.content पर स्थित है, और एक usage ऑब्जेक्ट प्रॉम्प्ट और पूर्णता टोकन की रिपोर्ट करता है। कमांड का हर हिस्सा एक काम करता है:
Authorization: Bearer ...टोकन वहन करता है। "Bearer" स्कीम का नाम है; जिसके पास टोकन होता है, उसे उसका मालिक माना जाता है, इसलिए इसे सार्वजनिक रिपॉजिटरी से बाहर रखें।Content-Type: application/jsonसर्वर को बॉडी को कैसे पढ़ना है, यह बताता है। इसके बिना, अनुरोध अक्सर बॉडी पार्स करने में त्रुटि के साथ विफल हो जाता है।modeluncensoredहोना चाहिए, वह एकमात्र मॉडल जिसे यह API प्रदान करता है।messagesएक ऑब्जेक्ट्स की सूची है जिसमेंrole(system, user, assistant या tool) औरcontentहोता है।
कुंजी प्राप्त करने के लिए, Google या ईमेल और पासवर्ड से साइन अप करें, फिर API कुंजी पृष्ठ का उपयोग करें। नए उपयोगकर्ता वहाँ एक क्लिक से $0.50 का मुफ़्त ट्रायल क्रेडिट क्लेम कर सकते हैं: कोई कार्ड नहीं, 7 दिनों के लिए मान्य, प्रति व्यक्ति एक।
GET /v1/models के साथ कुंजी की जाँच करें
लंबे अनुरोध को डिबग करने से पहले, सुनिश्चित करें कि टोकन उपलब्ध सबसे सस्ते कॉल के साथ काम करता है। मॉडल सूचीबद्ध करने में कुछ नहीं लगता और यह दिखाता है कि क्या URL, हेडर और कुंजी सभी सही हैं।
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY"
एक अच्छा उत्तर एक JSON सूची है जिसमें uncensored शामिल है। यदि आपके पास jq इंस्टॉल है, तो आउटपुट को केवल ID निकालने के लिए पाइप करें:
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'
यदि कुछ भी उपयोगी नहीं आता है, तो नीचे दी गई सूची को क्रम से देखें, क्योंकि कारणों को उनकी घटना की आवृत्ति के अनुसार सूचीबद्ध किया गया है:
- चर खाली है।
echo "${UF_KEY:0:6}"चलाएँ ताकि पूरी कुंजी प्रिंट किए बिना पहले अक्षर देख सकें। - हेडर में वर्तनी त्रुटि है, या कुंजी से पहले "Bearer" गायब है।
- दस्तावेज़ या चैट क्लाइंट से कर्ली कोट्स ने कमांड में स्ट्रेट कोट्स को बदल दिया है।
- बेस URL गलत है। यह
https://api.unfilteredaimodels.com/v1है, जिसके आगेapi.और अंत में/v1है। - कुंजी को कॉपी करते समय अंत में स्पेस या नई लाइन आ गई है।
प्रतिक्रिया हेडर पढ़ें
आउटपुट में हेडर शामिल करने के लिए -i जोड़ें, या शरीर को साफ़ रखते हुए उन्हें प्रिंट करने के लिए -D - जोड़ें:
curl -s -D - -o /dev/null \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'
चार प्रतिक्रिया हेडर जानने योग्य हैं:
| हेडर | अर्थ |
|---|---|
X-Request-Id | इस अनुरोध के लिए पहचानकर्ता। यदि आप सहायता से संपर्क करते हैं, तो इसे शामिल करें। |
X-Balance-USD | आपका शेष प्रीपेड क्रेडिट। |
X-RateLimit-Limit-Requests | आपकी कुंजी के लिए प्रति मिनट अनुमत अनुरोध। |
X-RateLimit-Limit-Concurrency | आपकी कुंजी के लिए अनुमत समानांतर अनुरोध। |
सीमाएँ एक पूर्ण कुंजी के लिए प्रति मिनट 300 अनुरोध और 8 समानांतर अनुरोध हैं, और एक ट्रायल कुंजी के लिए प्रति मिनट 60 और 2 समानांतर हैं। ऊपर दिया गया अनुरोध max_tokens को 5 पर सेट करता है ताकि परीक्षण छोटा रहे। सामान्य उपयोग में max_tokens वैकल्पिक है, और पूर्णता आपके प्रॉम्प्ट के बाद 100,000-टोकन विंडो के जो भी शेष बचता है, उसका उपयोग कर सकती है।
कमांड लाइन से स्ट्रीमिंग
"stream": true सेट करें और -N जोड़ें ताकि curl आउटपुट को बफर न करे। आप data: से शुरू होने वाली पंक्तियाँ देखेंगे, जिनमें छोटा JSON अंतर होता है, और अंत में data: [DONE]। उससे पहले के चंक में टोकन उपयोग शामिल होता है।
curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
}'
केवल पाठ प्रिंट करने के लिए, स्ट्रीम को एक छोटी पाइपलाइन के साथ फ़िल्टर करें:
curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
| sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
| jq -rj '.choices[0].delta.content // empty'
echo
एक स्ट्रीम किए गए अनुरोध में समानांतरता स्लॉट बना रहता है जब तक स्ट्रीम समाप्त नहीं हो जाती। यदि आप एक स्क्रिप्ट से कई स्ट्रीम समानांतर रूप से शुरू करते हैं और उन्हें समाप्त होने देना भूल जाते हैं, तो आप समानांतरता सीमा पर पहुँच जाएंगे भले ही अनुरोध दर कम हो।
JSON मोड और टूल कॉल्स
JSON मोड मॉडल को एक मान्य JSON ऑब्जेक्ट लौटने देता है। अपने वांछित स्वरूप को प्रॉम्प्ट में भी बताएं, अन्यथा कुंजियाँ मॉडल द्वारा चुनी गई होगी।
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
]
}' | jq -r '.choices[0].message.content'
टूल कॉलिंग मानक tools और tool_choice फ़ील्ड्स का उपयोग करती है। मॉडल टेक्स्ट के बजाय एक tool_calls एरे के साथ जवाब देता है; आप फ़ंक्शन स्वयं चलाते हैं और परिणाम को role: "tool" और मिलते-जुलते tool_call_id के साथ एक संदेश के रूप में वापस भेजते हैं।
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"tool_choice": "auto",
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
}'
प्रतिक्रिया में choices[0].message.tool_calls[0].function.arguments खोजें। यह एक JSON स्ट्रिंग है जिसे आप पार्स करते हैं, अपने मौसम फ़ंक्शन को कॉल करते हैं और अगले अनुरोध में वापस करते हैं। temperature, top_p, stop, seed जैसे पैरामीटर और पेनल्टीज़ पास किए जाते हैं। दस्तावेज़ीकरण में सभी समर्थित फ़ील्ड सूचीबद्ध हैं।
टोकन को सुरक्षित रखें और कमांड्स को व्यवस्थित रखें
Bearer टोकन एक पासवर्ड है जिसका नाम अलग है। जिसके पास यह होता है, वह आपका क्रेडिट खर्च कर सकता है, इसलिए इसे उसी सावधानी से संभालें। कभी भी असली कुंजी को सार्वजनिक मुद्दे, स्क्रीनशॉट या साझा टर्मिनल लॉग में पेस्ट न करें। यदि आपको लगता है कि कुंजी लीक हो गई है, तो कुंजी पृष्ठ से इसे बदलें और अपने स्क्रिप्ट अपडेट करें।
शेल इतिहास एक व्यक्तिगत मशीन पर सबसे आम लीक है। कुंजी को सीधे कमांड में टाइप करने से वह इतिहास फ़ाइल में स्टोर हो जाती है। export के साथ एक बार सेट करने से भी वह लाइन स्टोर हो जाती है। दो साफ आदतें मदद करती हैं। कुंजी को उस फ़ाइल से पढ़ें जिसे केवल आप खोल सकते हैं, या यदि आपका शेल स्पेस से शुरू होने वाली लाइनों को अनदेखा करने के लिए सेट है तो कमांड के आगे स्पेस लगाएँ। एक छोटी फ़ाइल अच्छी तरह काम करती है:
mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key
export UF_KEY="$(cat ~/.config/uf/key)"
लंबे JSON बॉडी सिंगल कोट्स के अंदर पढ़ने में कठिन होते हैं, और प्रॉम्प्ट में अपोस्ट्रॉफ़ होने पर क्वोटींग टूट जाती है। बॉडी को एक फ़ाइल में रखें और curl को -d @file से पढ़ने दें:
cat > request.json <<'JSON'
{
"model": "uncensored",
"temperature": 0.3,
"messages": [
{"role": "system", "content": "You answer in plain language."},
{"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
]
}
JSON
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d @request.json | jq -r '.choices[0].message.content'
यही दृष्टिकोण 8 MB की बॉडी सीमा के अंदर बड़े प्रॉम्प्ट को प्रबंधनीय रखता है, और एक फ़ाइल को git में संस्करणित किया जा सकता है जबकि कुंजी रिपॉजिटरी के बाहर रहती है। विंडोज़ पावरशेल में JSON के आसपास एकल कोट्स अलग व्यवहार करते हैं और बैकस्लैश लाइन कंटिन्यूएशन मौजूद नहीं है; -d @request.json रूप दोनों समस्याओं से बचाता है, और आप एक कमांड को जारी रखने के लिए लाइन के अंत में बैकटिक का उपयोग कर सकते हैं।
जब आप टेस्टिंग समाप्त कर लें, तो एक SDK पर जाएं। OpenAI Python और Node लाइब्रेरी समान Base URL और कुंजी स्वीकार करती हैं, आपके लिए रीट्राइज़ और स्ट्रीमिंग हैंडल करती हैं, और उसी प्रतिक्रिया फ़ॉर्मेट को पढ़ती हैं जिसे आपने यहाँ हाथ से पार्स किया है। cURL कमांड्स विफलता आपके कोड से आ रही है या अनुरोध से, यह जाँचने का सबसे तेज़ तरीका रहता है, इसलिए अपने नोट्स में एक ज्ञात-अच्छा कमांड रखें। जब आप सहायता को समस्या की रिपोर्ट करते हैं, तो विफल कॉल का X-Request-Id और सटीक स्टेटस कोड शामिल करें; वह जोड़ा किसी को अनुरोध खोजने में मदद करता है बिना आपको टेस्ट दोहराने के लिए कहें, और यह आदान-प्रदान बचाता है।
त्रुटियाँ, रेट्राइज़ और कॉल प्रति लागत
जब आप एक लिमिट पार कर लेते हैं, तो API HTTP 429 उत्तर देता है। त्रुटि कोड आपको बताता है कि कौन सी लिमिट: rate_limited का मतलब प्रति मिनट बहुत सारे अनुरोध हैं, concurrency का मतलब एक साथ बहुत सारे हैं। एक अस्थायी ओवरलोड भी 429 लौटाता है और Retry-After: 5 जोड़ता है। curl स्वयं अस्थायी त्रुटियों पर पुनः प्रयास कर सकता है:
curl --retry 3 --retry-delay 5 --retry-all-errors \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
बॉडी को 8 MB के अंदर रखें, जो मायने रखता है यदि आप प्रॉम्प्ट में एन्कोडेड फ़ाइलें पोस्ट करते हैं।
विफल या अस्वीकृत अनुरोधों का शुल्क नहीं लिया जाता है। सफल अनुरोध एक सरल सूत्र का पालन करते हैं: 1M इनपुट टोकन प्रति $0.15 और 1M आउटपुट टोकन प्रति $0.50। 40 इनपुट टोकन और 120 आउटपुट टोकन के साथ एक टेस्ट कॉल की लागत 40 / 1,000,000 x $0.15 = $0.000006 प्लस 120 / 1,000,000 x $0.50 = $0.00006 होती है, इसलिए कुल $0.000066। उनमें से एक हज़ार $0.066 आते हैं।
क्रेडिट प्रीपेड होता है और कभी समाप्त नहीं होता। टॉप-अप $20 से $500 तक पूर्ण राशि में होते हैं, $50 से 5%, $100 से 10% और $200 से 15% बोनस मिलता है, क्रिप्टो (TRC20 पर USDT, Base पर USDC) से। मूल्य निर्धारण पृष्ठ विवरण दिखाता है। यदि प्रतिक्रिया गलत लगती है, तो अफवाहें और तथ्य पृष्ठ समझाता है कि मॉडल क्या करता है और क्या नहीं करता।
अधिक गाइड
प्रश्न और उत्तर
आपकी कुंजी बस एक फ़ॉर्म दूर है
एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।
टोकन cURL कमांड में कहाँ जाता है?
- एक हेडर में: -H "Authorization: Bearer YOUR_KEY"। रिक्वेस्ट बॉडी को Content-Type: application/json हेडर की भी आवश्यकता है।
मुझे कौन सा मॉडल नाम उपयोग करना चाहिए?
- बिना सेंसर का उपयोग करें। आप इसे GET /v1/models से पुष्टि कर सकते हैं।
मुझे 429 क्यों मिलता है?
- आपने एक लिमिट पार कर दी है। कोड rate_limited का मतलब प्रति मिनट बहुत सारे अनुरोध हैं, concurrency का मतलब एक साथ बहुत सारे अनुरोध हैं। कुछ सेकंड प्रतीक्षा करें, या समानांतर कॉल्स की संख्या कम करें।
मैं अपना शेष क्रेडिट कैसे देखूं?
- हर रिस्पॉन्स में एक X-Balance-USD हेडर शामिल होता है। curl -i या curl -D - के साथ हेडर प्रिंट करें।
क्या यह आधिकारिक OpenAI API है?
- नहीं। यह एक स्वतंत्र OpenAI-कम्पैटिबल सेवा है जो एक ओपन-वेट मॉडल चलाती है, इसलिए OpenAI फॉर्मेट के लिए बनाए गए SDK और cURL कमांड्स बेस यूआरएल और कुंजी बदलने के बाद काम करते हैं।