為 API 請求揀選執行供應商
使用 ShareAI provider 物件,喺所有四個推理端點中,獨立於模型嘅 Creator 選擇執行 provider。
喺呢頁面
設定 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 同意、計費資格同設備可用性繼續適用。
下一步#
最後更新日期 2026年9月16日