اختيار مزودي التنفيذ لطلب 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