跳到主要内容

创建 Auto 分组令牌

Auto 是自动路由分组。它会根据请求中的 model 名称，在可用分组中寻找通道，并按「调整分组顺序」里的优先级选择。

如果你希望一把 Key 调用多个分组里的模型，就用 Auto。

提示

对分组倍率、优先级和自动路由规则不熟悉时，直接选具体分组，先不要用 Auto。 Auto 出问题时不好定位。

适合什么时候用​

  • 需要用同一把 Key 调用多个模型分组
  • 希望某个渠道不可用时，按顺序尝试其他分组
  • 能根据模型广场和分组倍率判断路由范围与费用

创建步骤​

1. 打开令牌管理并添加令牌​

控制台 → 令牌管理 → 添加令牌，填写令牌名称。

2. 选择 Auto 分组​

在「令牌分组」中选择 Auto。

信息

Auto 不是一个具体模型渠道，而是把多个分组组合成一条自动路由规则。

3. 调整参与路由的分组（可选）​

创建 Auto 时不需要勾选具体分组。点「调整分组顺序」，按优先级拖动已有分组排列 —— 列表靠前的分组优先使用。

注意

Auto 只能调整顺序，不能通过勾选/取消勾选来改变分组范围。

建议先打开 模型广场，确认要调用的模型、支持的接口和对应分组，再按使用优先级调整顺序。需要覆盖当前开放模型时，保持默认分组范围，并将「模型可用列表」留空。

4. 提交并复制 API Key​

完成过期时间、额度和其他字段设置后提交令牌。回到令牌列表，在密钥栏直接复制完整 API Key。

提示

复制出来的是纯 Key，通常以 sk- 开头，不包含 Bearer。

调用方式​

使用 Auto Key 时，Authorization 保持不变，切换模型只需要改 model：

curl https://187api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名>",
    "messages": [{"role": "user", "content": "你好"}]
  }'

查看当前 Key 可见的模型：

curl https://187api.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

跨分组重试​

Auto 分组支持跨分组重试：当前分组没有可用通道时，自动尝试下一个分组。这需要在令牌上开启 cross_group_retry（控制台对应「跨分组重试」开关）。

信息

只在 Auto 分组下有效。具体分组不会跨组重试。

一把 Key 同时跑文本和图片​

一把 Auto 令牌可以同时调用文本模型和图片模型：文本请求走对应文本分组，图片请求走对应图片分组。这样不用为 Codex 和生图分别创建两把 Key。

# 文本请求
curl https://187api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"model": "<文本模型>", "messages": [{"role":"user","content":"你好"}]}'

# 图片请求（同一把 key）
curl https://187api.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"model": "<图片模型>", "prompt": "一只猫"}'

常见问题​

Auto 能不能调用所有模型？​

Auto 会根据模型名称在当前可用分组中自动路由。如果没有额外填写「模型可用列表」，同一把 Key 可以调用模型广场当前开放的模型。

模型广场更新后，只需重新检查分组顺序和模型名称。

不知道优先级怎么设置怎么办？​

不要选 Auto，直接创建具体分组的令牌。具体分组更容易理解，也更方便定位模型权限、接口或计费问题。

Auto 和具体分组怎么选？​

场景选择
只用一两个模型，要精确控制权限具体分组
要用一把 Key 覆盖多个分组Auto
排查权限/计费问题具体分组
某渠道挂了要自动降级Auto + 跨分组重试

相关：令牌分组说明 · 创建 API 令牌 · 模型广场 · [常见问题]../reference/faq/overview