انتخاب ارائهدهندگان اجرا برای درخواست 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