APIリクエストの実行プロバイダーを選択する
ShareAIプロバイダーオブジェクトを使用して、すべての4つの推論エンドポイントにおいてモデルのCreatorとは独立して実行プロバイダーを選択します。
このページについて
設定 model 正確なクリエイターベースの識別子に対して。 provider リクエストを実行する資格のあるインフラを制限またはランク付けしたい場合に追加します。これを省略すると、デフォルトの価格昇順ポリシーが使用されます。
1つのプロバイダーを使用する#
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 実際の小文字のプロバイダータグを使用してください。この順序付きリストとフォールバックが無効の場合、リストされたプロバイダーのみがその順序で適格です。最初のプロバイダーが利用できない場合でも、2番目のプロバイダーが選択される可能性があります。
資格制限を維持する#
リクエストはAPIキーで許可されたモデルとプロバイダーを絞り込むことができます。それ以外の権限を超えてアクセスを許可することはできません。OAuth同意、請求資格、デバイスの可用性は引き続き適用されます。
次へ#
最終更新日 2026年9月16日