指定通道
指定通道（provider / modelKey）
同一模型可能挂在多个供应商通道上。默认由平台自动选路；若你需要固定某一通道，可在模型字段里用 {provider}/{modelKey} 写法指定。
说明：只改请求体中的模型字段，URL 路径不变（仍是
/v1/chat/completions、/api/ai/tasks等）。这与 供应商原生接口兼容（/bailian、/ark路径迁移）不是同一能力。
何时使用
| 场景 | 建议 |
|---|---|
| 不关心走哪条通道 | 直接写模型 ID，例如 qwen-plus（默认自动选路） |
| 希望固定某一供应商通道 | 使用 provider/modelKey，例如 quartz/qwen-plus |
| 要复用百炼 / 方舟原生 HTTP 路径 | 使用 供应商原生接口兼容 |
可用通道以控制台「模型超市」详情中的渠道列，以及账号授权结果为准。
写法
在对应 API 的模型字段中写入：
{provider}/{modelKey}
| 部分 | 含义 | 示例 |
|---|---|---|
provider | 通道标识（控制台渠道代码，或平台对外别名） | quartz |
modelKey | 模型 ID（与不带前缀时相同） | qwen-plus |
| 完整取值 | 固定走该通道调用该模型 | quartz/qwen-plus |
写在哪个字段
| API | 字段名 | 示例 |
|---|---|---|
| OpenAI 兼容（Chat / Responses） | model | "model": "quartz/qwen-plus" |
| Anthropic 兼容（Messages） | model | "model": "quartz/qwen3.6-plus" |
| 平台异步任务 | modelKey | "modelKey": "quartz/qwen-image-plus" |
术语说明见 模型列表与元信息。
解析规则
- 若字符串中含
/，且/之前是平台已注册的通道（含对外别名），则固定该通道，/之后作为模型 ID。 - 若
/前不是合法通道，则整串当作模型 ID（不会剥前缀）。 - 未写前缀时，仍按账号配置做自动选路。
部分通道对外使用中性别名（例如 quartz），与控制台内部注册名等价，入站时可任选其一（以当前环境实际下发为准）。
示例：对话补全
端点与鉴权同 对话补全（OpenAI 兼容），仅 model 带通道前缀：
curl {{API_BASE_URL}}/v1/chat/completions \
-H "Authorization: Bearer uas_xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "quartz/qwen-plus",
"messages": [
{"role": "user", "content": "你好"}
]
}'
{
"model": "quartz/qwen-plus",
"messages": [
{"role": "user", "content": "你好"}
]
}
示例：异步任务
端点与鉴权同 异步任务（图像/视频/文本），仅 modelKey 带通道前缀：
curl {{API_BASE_URL}}/api/ai/tasks \
-H "Authorization: Bearer uas_xxx" \
-H "Content-Type: application/json" \
-d '{
"modelKey": "quartz/qwen-image-plus",
"imageParams": {
"prompt": "赛博朋克风格城市夜景",
"resolution": "2k",
"aspectRatio": "1:1"
}
}'
{
"modelKey": "quartz/qwen-image-plus",
"imageParams": {
"prompt": "赛博朋克风格城市夜景",
"resolution": "2k",
"aspectRatio": "1:1"
}
}
注意
- 指定的通道须对该模型已开通，且账号已授权该模型；否则会按现有错误码返回失败（见 错误码与限流）。
- 前缀只影响选哪条通道，其余参数（
messages、imageParams等）与不带前缀时相同。 - 不要把
{provider}/{modelKey}拼进 URL 路径；路径仍用各 API 文档中的固定入口。