自定义 Auto 分组
创建自己的分组顺序，绑定 API Key，并了解更名、下线和计费规则。
自定义 Auto 是属于你自己账号的一份分组选择顺序。你可以创建多份配置，例如「日常编程」「批量任务」，再把不同 API Key 绑定到对应配置。
同一份配置可以绑定多把 Key；修改一次，这些 Key 后续的请求都会使用新的顺序。它不会新增模型、改变模型售价，或授予账号原本没有的分组权限。
第一步：创建自己的 Auto
- 登录
https://console.zcloudapi.com，在控制台左侧打开「自定义 Auto 分组」。 - 点击「新建 Auto」，填写容易识别的名称，例如「日常编程」。
- 在「添加分组」下拉框里选择你需要的分组。这里只能添加当前账号有权限使用的分组，不能把另一个 Auto 嵌套进来。
- 用每行右侧的上移、下移按钮调整顺序，越靠前越优先。点击移除按钮可去掉不想使用的分组。
- 至少保留一个分组，点击「保存更改」。
页面只列出你自己的配置。你也可以复制一份已有配置，再修改名称和顺序，分别用于不同用途。
第二步：让 API Key 使用这份配置
- 打开「API 密钥」，新建 Key 或编辑一把已有 Key。
- 在分组中选择
auto。 - 在下方的 Auto 路由选项里，选择刚才保存的「日常编程」。
- 设置这把 Key 的额度、有效期和模型限制，然后保存。
选择「官方 Auto」则使用平台默认路由，不绑定你的个人配置。已有官方 Auto Key 不会因为你新建了个人配置而自动改绑。
修改现有 Key 的绑定不会改变 Key 字符串，客户端不需要重新复制 Key。多把 Key 绑定同一份配置后，在「自定义 Auto 分组」页面编辑这份配置即可统一调整。
第三步：按原来的 API 方式调用
自定义 Auto 不需要新的域名、接口或请求参数，也不要把配置名称写进 model。请求仍然传真实模型名，服务器根据这把 Key 绑定的配置选择分组。
先确认当前 Key 的模型列表：
export ZCLOUD_BASE_URL="https://api.zcloudapi.com/v1"
export ZCLOUD_API_KEY="sk-你的-ZCloudAPI-Key"
curl "$ZCLOUD_BASE_URL/models" \
-H "Authorization: Bearer $ZCLOUD_API_KEY"
列表同时受自定义 Auto 中的有效分组、渠道可用模型和 Key 的模型限制影响。加入分组不代表所有模型都一定可调用。
例如，确认列表中有 gpt-5.6-sol 后：
curl "$ZCLOUD_BASE_URL/responses" \
-H "Authorization: Bearer $ZCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"input": "说明如何设计一个任务队列，并给出一个例子。",
"stream": true
}'
Claude 继续使用 Messages 接口，图片继续使用 生成或编辑接口。同一把 Key 能否跨模型使用，取决于你是否加入了对应的授权分组。
顺序怎样生效
假设你保存的是下面的顺序。这些是说明用的示例，不代表任何实际分组的价格或官方路由。
| 顺序 | 分组 | 支持的模型 |
|---|---|---|
| 1 | 文本线路 A | GPT |
| 2 | 文本线路 B | GPT |
| 3 | 编程线路 C | Claude |
- 调用 GPT 时，优先考虑线路 A；线路 C 不支持该模型，不会用来承接 GPT 请求。
- 调用 Claude 时，跳过不支持 Claude 的 A、B，选择线路 C。
- 开启 Key 的跨分组重试后，符合平台重试条件的失败可以继续尝试你配置中的后续分组。已经发出的流式正文不能撤回，因此不是所有错误都会自动切换。
- 所选分组全部不可用时，会明确返回错误，不会回退到官方 Auto 或使用你没有加入的分组。
保存修改后，后续请求会采用更新后的配置；正在执行的请求保留开始时的顺序，不会因为你在页面上重新排序而中途换序。配置同步可能有短暂缓存延迟。
分组更名或下线之后
| 平台的调整 | 对你的配置和 Key 的影响 |
|---|---|
| 分组更名 | 绑定关系保留，页面显示新名称，不需要重新添加 |
| 分组下线并指定替代分组 | 在账号仍有权限的前提下，跟随替代关系选择新分组 |
| 分组下线且没有替代分组 | 在 Auto 中跳过；所有候选都不可用时返回错误 |
| 新增一个分组 | 不会自动加入你的个人配置，需要你主动添加 |
| 多个旧分组指向同一个替代组 | 请求选择时会去重，不会因为重复引用而反复轮询同一组 |
替代分组不一定支持原分组的全部模型，倍率也可能不同。遇到模型不可用时，重新查询 /v1/models，并到「使用日志」确认实际使用的分组。
怎样计费
自定义 Auto 不设置独立售价。费用按实际选中的分组及其当前计费规则计算，不按配置名称收费，也不把多个分组的费用相加。
例如，某模型的平台基础输入价为 $5 / 1M tokens，实际选中的分组倍率为 0.6x，则该档输入单价为 $3 / 1M tokens；输出、缓存和其他费用分别按对应规则计算。页面金额沿用平台现有展示口径，详见 计费与分组。
请求完成后，在「使用日志」查看实际分组、模型、Token 用量和最终扣费。排序只能决定优先尝试哪些分组，不能锁定未来价格。
修改或删除配置
- 点击编辑可修改名称、分组和顺序；所有绑定这份配置的 Key 都会跟随更新。
- 想让某把 Key 独立使用另一套顺序，可以先复制配置，再到「API 密钥」修改这把 Key 的绑定。
- 仍有 Key 绑定的配置不能删除。先将这些 Key 改绑到其他自定义 Auto 或官方 Auto，再删除配置。
- 每个账号最多创建 50 份配置，每份包含 1 至 100 个不重复的分组。其他账号不能查看或编辑你的配置。