リセラー/ベンダー指定
ベンダーと順序の指定
1 つのモデルを複数のベンダーが提供することがあります。たとえば deepseek-v4.1-flash は deepseek、opencode、volcengine のいずれかで提供されます。デフォルトではプラットフォームが優先度に従ってベンダーを選び、利用できないベンダーがあれば次のベンダーに切り替えます。料金はモデルだけで決まり、どのベンダーがリクエストを処理したかには左右されません。自分で制御したい場合は、リクエストボディに provider オブジェクトを追加してください。
このページの内容expand_more
provider のフィールドlink
only指定したベンダーのみを使います。例：{"only": ["deepseek"]}。
ignore指定したベンダーは使いません。例：{"ignore": ["opencode"]}。
order指定したベンダーをこの順に試し、利用できない場合は次のベンダーに移ります。指定していないベンダーも最後のフォールバックとして使われます。除外したい場合は order を only または ignore と組み合わせてください。
ベンダー IDlink
provider が意味を持つのは、ベンダーが複数あるモデルだけです。Claude、GPT、Gemini、Grok などのクローズドモデルは公式ベンダーのみが提供するため、指定は不要です。現在使われているベンダー ID は以下のとおりです。各モデルを提供するベンダーは、モデル詳細ページの「ベンダー」行（デフォルトの優先順）と、GET https://wokey.ai/api/models の providers フィールドに表示されます。
| ベンダー ID | ベンダー |
|---|---|
| deepseek | DeepSeek（公式） |
| moonshot | Kimi（公式、Moonshot AI） |
| zhipu | GLM（公式、Zhipu） |
| minimax | MiniMax（公式） |
| volcengine | Volcengine Ark：Doubao のほか、一部の DeepSeek、GLM、Kimi、MiniMax モデル |
| opencode | OpenCode Go：Tencent Hy4 のほか、一部の DeepSeek、GLM、Kimi、MiniMax モデル |
| ollama | Ollama Cloud：一部の DeepSeek、GLM、Kimi、MiniMax モデル |
例link
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [
{ "role": "user", "content": "Hello" }
],
"provider": {
"order": ["volcengine", "deepseek"],
"ignore": ["opencode"]
}
}'OpenAI と Anthropic の Python SDK は未知のトップレベル引数を拒否するため、provider は extra_body で渡してください。
from openai import OpenAI
client = OpenAI(base_url="https://api.wokey.ai/v1", api_key="YOUR_API_KEY")
response = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "Hello"}],
extra_body={"provider": {"only": ["deepseek"]}},
)
print(response.choices[0].message.content)注意事項link
- /chat/completions、/responses、/messages のいずれも同じ形式で受け付けます。
- 不明なベンダー ID を指定すると 400 invalid_request_error が返ります。モデルのすべてのベンダーを除外する指定では 404 no_eligible_provider が返ります。
- provider は選択肢を絞り込むだけです。API キーに設定されたベンダー制限と併せて適用され、キーで除外したベンダーを再び有効にすることはできません。
- プロンプトキャッシュを維持するため、別のベンダーに移った会話はそのベンダーにとどまり、順序の先頭のベンダーには戻りません。
- provider はプラットフォーム向けのルーティング指示であり、アップストリームには転送されません。