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