代理转售/指定供应商
指定供应商与顺序
同一个模型可能有多家供应商，例如 deepseek-v4.1-flash 可以走 deepseek、opencode、volcengine。默认由平台按优先级自动选择，某家不可用时自动换下一家。价格只按模型计，和实际走哪家供应商无关。需要自己控制时，在请求体里加 provider 对象。
本页内容expand_more
provider 参数link
only只使用列出的供应商，例如 {"only": ["deepseek"]}。
ignore不使用列出的供应商，例如 {"ignore": ["opencode"]}。
order按列出的顺序优先使用。排在前面的不可用时依次换下一家；没列出的供应商排在最后兜底，想完全排除请配合 only 或 ignore。
供应商 IDlink
provider 只对有多家供应商的模型有意义；Claude、GPT、Gemini、Grok 等闭源模型只由官方供应，不需要填。目前用到的供应商 ID 见下表。某个模型具体由哪几家供应，以模型详情页的「供应商」一栏为准（按默认优先级排列），也可以看 GET https://wokey.ai/api/models 返回的 providers 字段。
| 供应商 ID | 供应商 |
|---|---|
| deepseek | DeepSeek 官方 |
| moonshot | Kimi 官方（月之暗面） |
| zhipu | GLM 官方（智谱） |
| minimax | MiniMax 官方 |
| volcengine | 火山方舟：豆包，以及部分 DeepSeek、GLM、Kimi、MiniMax 模型 |
| opencode | OpenCode Go：腾讯 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 不接受未知的顶层参数，provider 要放进 extra_body。
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 Key 上设置的供应商限制同时生效，不能放开 Key 已排除的供应商。
- 为了保住缓存，同一会话中途换过供应商后会留在当前这家，不会立刻按 order 切回。
- provider 只用于平台路由，不会转发给上游。