अपनी पहली API रिक्वेस्ट करें
एक ShareAI API कुंजी बनाएं, एक उपलब्ध मॉडल चुनें और अपने सर्वर से Bearer प्रमाणीकरण के साथ एक चैट अनुरोध भेजें।
इस पेज पर
यहां से शुरू करें जब आपका एप्लिकेशन आपके अपने ShareAI वर्कस्पेस से API कुंजी का उपयोग करके अनुरोध करेगा। आपको एक ShareAI खाता, एक सक्रिय कुंजी और उस मॉडल तक पहुंच की आवश्यकता है जिसे आप चलाना चाहते हैं।
1. एक API कुंजी बनाएं#
खोलें ShareAI कंसोल और उस वर्कस्पेस का चयन करें जो कुंजी और उपयोग का मालिक होगा। खोलें API कुंजियाँ, चुनें API कुंजी बनाएं, कुंजी को एक पहचानने योग्य नाम दें और इसे अपने सर्वर वातावरण में सुरक्षित करें।


2. एक मॉडल चुनें#
खोलें मॉडल्स और वहां दिखाए गए सटीक मॉडल पहचानकर्ता को कॉपी करें। वर्तमान उपलब्धता और आपकी कुंजी पर मॉडल/प्रोवाइडर प्रतिबंधों की जांच करें। किसी पुराने ट्यूटोरियल में एक पहचानकर्ता आज क्षमता उपलब्ध होने की गारंटी नहीं देता।
3. अनुरोध भेजें#
https://api.shareai.now/api/v1/chat/completionsएक उपलब्ध मॉडल का उपयोग करके प्रतिक्रिया उत्पन्न करें।
- बेस URL
https://api.shareai.now- प्रमाणीकरण
- Bearer API कुंजी
प्रतिस्थापित करें MODEL_IDENTIFIER आपके चयनित पहचानकर्ता के साथ। सेट करें SHAREAI_API_KEY अपने वातावरण में उदाहरण चलाने से पहले।
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'MODEL_IDENTIFIER', 'messages': [{'role': 'user', 'content': 'Explain what ShareAI does in one sentence.'}], 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
4. परिणाम पढ़ें#
एक सफल गैर-स्ट्रीमिंग अनुरोध के लिए, जांचें कि done सत्य है और सहायक संदेश को पढ़ें message.content। HTTP स्थिति और बॉडी में किसी भी त्रुटि ऑब्जेक्ट दोनों की जांच करें इससे पहले कि इसे सफल समापन के रूप में मानें। एक no-device परिणाम वर्तमान में HTTP 200 के साथ एक त्रुटि ऑब्जेक्ट के रूप में आ सकता है।
यदि अनुरोध विफल हो#
| स्थिति | अगला कदम |
|---|---|
| 401 | कुंजी, वर्कस्पेस और प्राधिकरण हेडर की जांच करें। |
| 402 | उपलब्ध क्रेडिट्स या लागू बैलेंस की जांच करें। |
| 403 | अनुमत मॉडल और प्रोवाइडर्स की जांच करें। |
| 429 | Retry-After मौजूद होने पर प्रतीक्षा करें, फिर सीमित देरी के साथ पुनः प्रयास करें। |
| 503 | वर्तमान क्षमता या सेवा उपलब्धता की जांच करें; एक पुनः प्रयास सीमा रखें। |
अगले कदम#
चैट अनुरोध और प्रतिक्रिया संदर्भ समर्थित बॉडी को समझाता है। यदि प्रत्येक ग्राहक को अपने खाते को अधिकृत करना चाहिए, तो पालन करें एप्लिकेशन OAuth.
अंतिम अपडेट सितम्बर 15, 2026