代理轉售/指定供應商
指定供應商與順序
同一個模型可能由多家供應商提供，例如 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（官方，智譜） |
| 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
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 會拒絕未知的頂層參數，因此請透過 extra_body 傳入 provider。
Python
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 是給平台的路由指令，絕不會轉送到上游。