अपने शेल को सेट करें और एंडपॉइंट की जांच करें
API कुंजी पेज से एक कुंजी प्राप्त करें, फिर इसे बेस URL के साथ एक्सपोर्ट करें ताकि आप हर कमांड में सीक्रेट्स पेस्ट न करें।
export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"
प्रत्येक अनुरोध Authorization हेडर में कुंजी को बीयरर टोकन के रूप में भेजता है। अनुरोध बॉडी JSON होती है, इसलिए POST करते समय Content-Type: application/json जोड़ें। अधिकतम बॉडी आकार 8 MB है, जो केवल तभी मायने रखता है जब आप प्रॉम्प्ट में बहुत बड़े दस्तावेज़ पेस्ट करें।
उदाहरणों में यूनिक्स शेल के एकल उद्धरण चिह्नों का उपयोग किया गया है। विंडोज़ पावरशेल पर, JSON को एक फ़ाइल में रखें और क्वोटिंग की समस्या से बचने के लिए --data @body.json के साथ इसे पास करें।
सबसे सस्ता सत्यापन एक GET अनुरोध है जो मॉडल सूचीबद्ध करता है। यह कुंजी और URL की पुष्टि करता है, और इसमें कुछ भी खर्च नहीं होता।
curl -s "$BASE/models" \
-H "Authorization: Bearer $API_KEY"
प्रतिक्रिया में data ऐरे में ID uncensored शामिल होनी चाहिए। 401 का अर्थ है कि कुंजी गायब है या टाइप करने में त्रुटि हुई है। यदि curl बिल्कुल कनेक्ट नहीं कर पा रहा है, तो $BASE में होस्ट जांचें और सुनिश्चित करें कि यह /v1 पर समाप्त हो, बिना किसी अतिरिक्त पथ के।
1. चैट पूर्णता भेजें
यह वह अनुरोध है जो हर OpenAI-शैली क्लाइंट अंदरूनी तौर पर भेजता है।
curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Give me three names for a fantasy tavern."}
],
"temperature": 0.8,
"max_tokens": 200
}'
प्रतिक्रिया JSON है। पाठ choices[0].message.content पर है, और टोकन गणना usage में है। यदि आपके पास jq इंस्टॉल है और केवल पाठ चाहते हैं, तो आउटपुट को jq -r '.choices[0].message.content' के माध्यम से पाइप करें। max_tokens फ़ील्ड वैकल्पिक है; इसे छोड़ दें और पूर्णता 100,000-टोकन विंडो में बचे हुए जो भी है, उसका उपयोग कर सकती है।
अगर आपका क्लाइंट उस प्रारूप का उपयोग करता है, तो नया POST /v1/responses एंडपॉइंट भी उपलब्ध है। पैरामीटर की पूरी सूची के लिए, दस्तावेज़ीकरण देखें।
2. उत्तर को स्ट्रीम करें
"stream": true जोड़ें और curl को -N के साथ बफर न करने दें। टोकन जनरेट होते ही प्रिंट होंगे।
curl -N "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Count from one to ten in words."}]
}'
प्रत्येक पंक्ति data: से शुरू होती है और एक छोटी JSON चंक रखती है जिसमें delta होता है। अंतिम इवेंट्स उपयोग (usage) लाते हैं, और स्ट्रीम data: [DONE] के साथ समाप्त होती है। -N के बिना curl पूरे बफर का इंतज़ार करता है, और आउटपुट ऐसा लगता है जैसे वह एक ही बार में आया है। ध्यान दें कि स्ट्रीम किए गए अनुरोध में एक कन्करेंसी स्लॉट अंत तक व्यस्त रहता है।
3. JSON मांगें
आउटपुट के लिए जिसे एक स्क्रिप्ट पार्स करेगी, JSON मोड को response_format के साथ चालू करें। प्रॉम्प्ट में JSON शब्द का उल्लेख करें ताकि मॉडल को पता चले कि आप किस आकार की उम्मीद कर रहे हैं।
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [{"role": "user",
"content": "Return JSON with keys name and level for a fantasy character."}]
}' | jq -r '.choices[0].message.content | fromjson'
अंतिम fromjson फ़िल्टर content के अंदर की स्ट्रिंग को पार्स करता है, इसलिए यदि मॉडल द्वारा कोई वैध JSON नहीं लौटाया गया तो jq स्पष्ट रूप से विफल हो जाता है। यह इसे एक उपयोगी त्वरित परीक्षण बनाता है। अधिक पैटर्न JSON मोड पेज पर उपलब्ध हैं।
4. टूल कॉल का प्रयास करें
टूल कॉलिंग मॉडल को आपके कोड में फ़ंक्शन चलाने के लिए कहती है। आप फ़ंक्शन को tools ऐरे में वर्णित करते हैं, और यदि मॉडल उसे उपयोग करने का निर्णय लेता है, तो प्रतिक्रिया में पाठ के बजाय एक tool_calls प्रविष्टि होती है।
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"tool_choice": "auto"
}' | jq '.choices[0].message.tool_calls'
आपको एक फ़ंक्शन नाम और तर्कों की JSON स्ट्रिंग मिलनी चाहिए। आपका कोड फ़ंक्शन चलाता है, फिर एक दूसरा अनुरोध भेजता है जो पिछले संदेशों को दोहराता है, टूल कॉल वाले असिस्टेंट संदेश को जोड़ता है, और role: "tool" वाले एक संदेश को जोड़ता है जिसमें परिणाम होता है। मॉडल फिर अंतिम उत्तर लिखता है।
5. हेडर और बैलेंस जांचें
बॉडी के साथ-साथ रिस्पॉन्स हेडर देखने के लिए -i जोड़ें। आपको X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests और X-RateLimit-Limit-Concurrency मिलेंगे।
curl -s -i "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
| grep -i "^x-"
curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"
दूसरा कॉल आपका क्रेडिट सीधे लौटाता है। OpenAI-शैली के टूल GET /v1/dashboard/billing/credit_grants का उपयोग कर सकते हैं। ऊपर दिया गया एक छोटा अनुरोध एक सेंट का अंश खर्च करता है: 10 इनपुट टोकन और 5 आउटपुट टोकन के साथ, कीमत 10 x 0.15 / 1,000,000 + 5 x 0.50 / 1,000,000 = $0.000004 है। दरों के लिए मूल्य निर्धारण पृष्ठ देखें।
एक पुन: प्रयोग योग्य स्मोक-टेस्ट स्क्रिप्ट
एक बार जब आप व्यक्तिगत कॉल पर भरोसा कर लेते हैं, तो उन्हें एक छोटी स्क्रिप्ट में बांधें जिसे आप किसी भी डिप्लॉय, कुंजी रोटेशन या नेटवर्क बदलाव के बाद चला सकते हैं। यह पहले समस्या पर विफल हो जाता है, इसलिए आप देखते हैं कि किस स्टेप में खराबी हुई।
set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"
echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'
echo "chat:"
curl -sf "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
| jq -r '.choices[0].message.content'
echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"
-f फ्लैग curl को HTTP विफलताओं पर त्रुटि के साथ बाहर निकलने का कारण बनता है, और set -e स्क्रिप्ट को वहीं रोक देता है। इसे एक cron जॉब या CI स्टेप में रखें यदि आप इस API के ऊपर एक सेवा चलाते हैं और कुछ बदलने पर एक शुरुआती चेतावनी चाहते हैं। कुंजी को एक सीक्रेट स्टोर या एन्वायरनमेंट वेरिएबल में रखें, कभी भी स्क्रिप्ट फ़ाइल में नहीं।
जब आप अनुरोध को बदलते हैं, तो एक समय में एक सेटिंग आज़माएं: temperature यादृच्छिकता के लिए, top_p न्यूक्लियस सैंपलिंग के लिए, stop कस्टम अंत अनुक्रमों के लिए, और seed दोहराने योग्य आउटपुट के लिए। वे सभी मॉडल में पास किए जाते हैं, इसलिए आप समान टर्मिनल इतिहास से उनके प्रभाव की तुलना कर सकते हैं।
curl से त्रुटियां पढ़ना
| स्थिति | संभावित कारण | समाधान |
|---|---|---|
| 401 | गुम या गलत कुंजी | Authorization हेडर की जांच करें और सुनिश्चित करें कि $API_KEY एक्सपोर्ट किया गया है |
| 400 | खराब JSON या खराब फ़ील्ड | भेजने से पहले jq . के साथ बॉडी की जाँच करें |
429, कोड rate_limited | प्रति मिनट 300 से अधिक अनुरोध (ट्रायल कुंजी पर 60) | अपने लूप को धीमा करें |
429, कोड concurrency | एक साथ 8 से अधिक अनुरोध (ट्रायल कुंजी पर 2) | कम समानांतर जॉब चलाएं |
429 के साथ Retry-After: 5 | अस्थायी ओवरलोड | 5 सेकंड प्रतीक्षा करें और पुनः प्रयास करें |
-w "\n%{http_code}\n" जोड़ें बॉडी के बाद स्टेटस कोड प्रिंट करने के लिए, जो आपको अनुमान लगाने से बचाता है। त्रुटि बॉडी JSON होती हैं जिनमें एक संदेश और कोड होता है, इसलिए jq .error उन्हें साफ़ दिखाते हैं। यदि आप एक लूप में 429 देखते हैं, तो तुरंत पुन: प्रयास न करें; कुछ सेकंड का विराम मिनट विंडो और समानांतर स्लॉट्स को साफ़ करने देता है, और एक तंग पुन: प्रयास लूप आपको सीमा से ऊपर ही रखता है। एक ट्रायल कुंजी की सीमाएं एक पूर्ण कुंजी की तुलना में अधिक कठोर होती हैं, इसलिए एक स्क्रिप्ट जो आपके पहले टॉप-अप के बाद काम करती है, यदि यह समानांतर में जॉब चलाती है तो ट्रायल क्रेडिट पर विफल हो सकती है। एक बार जब अनुरोध व्यवहार करने लगते हैं, तो एक SDK की ओर बढ़ें; वही URL और मॉडल नाम अपरिवर्तित रहते हैं। नए खाते एक क्लिक के साथ $0.50 का ट्रायल क्रेडिट दावा कर सकते हैं, जो सैकड़ों छोटे टेस्ट कॉल के लिए पर्याप्त है। उसके बाद टॉप-अप $20 से शुरू होते हैं और क्रिप्टो (TRC20 पर USDT या Base पर USDC) में भुगतान किए जाते हैं।
