API विनंतीसाठी कार्यवाही प्रदाते निवडा
ShareAI प्रदाता ऑब्जेक्ट वापरून कार्यवाही प्रदाते निवडा, मॉडेलच्या निर्मात्यापासून स्वतंत्रपणे सर्व चार इनफरन्स एंडपॉइंट्सवर.
या पृष्ठावर
सेट करा model अचूक निर्माते-आधारित ओळखकर्त्याला. जोडा provider जेव्हा तुम्हाला विनंती कार्यान्वित करण्यासाठी पात्र पायाभूत सुविधा मर्यादित किंवा क्रमवारीत लावायची असेल. ते वगळल्यास डिफॉल्ट किंमत-वाढीच्या धोरणाचा वापर होतो.
एक प्रदाता वापरा#
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 '{
"provider": {
"only": [
"shareai"
],
"allow_fallbacks": false
},
"model": "openai/gpt-5.4",
"messages": [
{
"role": "user",
"content": "Explain model routing in one sentence."
}
]
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'provider': {'only': ['shareai'], 'allow_fallbacks': False}, 'model': 'openai/gpt-5.4', 'messages': [{'role': 'user', 'content': 'Explain model routing in one sentence.'}]}
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 = {
"provider": {
"only": [
"shareai"
],
"allow_fallbacks": false
},
"model": "openai/gpt-5.4",
"messages": [
{
"role": "user",
"content": "Explain model routing in one sentence."
}
]
};
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());
निवडलेल्या मॉडेलसाठी दर्शविलेले प्रदाता टॅग वापरा. only ही एक कठोर मर्यादा आहे: फॉलबॅक परवानगी दिल्यास कधीही या यादीबाहेरील प्रदात्याला परवानगी दिली जात नाही.
प्रत्येक इनफरन्स एंडपॉइंटवर समान धोरण वापरा#
| एंडपॉइंट | मुख्य इनपुट फील्ड | समर्थन करणारे मॉडेल निवडा |
|---|---|---|
/api/v1/chat/completions | messages | चॅट पूर्णता |
/api/v1/responses | input | प्रतिसाद |
/api/v1/embeddings | input | एम्बेडिंग्ज |
/api/v1/images/generations | prompt | प्रतिमा निर्मिती |
प्रदाता धोरणाचा या एंडपॉइंट्सवर समान अर्थ आहे. मॉडेल आणि प्रदाता क्षमता वेगवेगळ्या आहेत: चॅट मॉडेल स्वयंचलितपणे एम्बेडिंग किंवा इमेज मॉडेल नसते. ऑपरेशनसाठी पात्र ओळखकर्ता कॅटलॉगमधून कॉपी करा; नेटिव एंडपॉइंट्सला कॉन्फिगर केलेला समर्थन आवश्यक आहे.
नामांकित प्रदात्यांना प्राधान्य द्या#
JSON
{
"provider": {
"order": [
"PROVIDER_A",
"PROVIDER_B"
],
"allow_fallbacks": false,
"sort": {
"by": "price",
"direction": "asc"
}
}
}
बदला PROVIDER_A आणि PROVIDER_B वास्तविक लोअरकेस प्रदाता टॅगसह. या क्रमित यादीसह आणि फॉलबॅक अक्षम असल्यास, फक्त सूचीबद्ध प्रदाते पात्र आहेत, त्या क्रमाने. पहिला उपलब्ध नसल्यास दुसरा सूचीबद्ध प्रदाता निवडला जाऊ शकतो.
क्रेडेन्शियल निर्बंध ठेवा#
तुमची विनंती API कीच्या परवानगी असलेल्या मॉडेल्स आणि प्रदात्यांना मर्यादित करू शकते. ती त्या परवान्यांच्या बाहेर प्रवेश देऊ शकत नाही. OAuth संमती, बिलिंग पात्रता आणि डिव्हाइस उपलब्धता लागू राहते.
पुढे#
शेवटचे अद्यतनित सप्टेंबर 16, 2026