创建令牌(API Key)

在 QuickRouter 控制台创建 API Key。首次配置推荐保留「智能路由」,使用「智能自动」选线路。

控制台图文教程

进入 QuickRouter 控制台,登录自己的账号。创建前可先在 模型价格页确认目标模型 ID、调用协议及支持的分组。点击配图可在页内放大。

优先使用智能路由

新建令牌时,保持智能路由开启。首次配置选智能自动。需要优先考虑费用、响应速度或成功率时,可换用对应策略。

智能路由会在账号可访问的分组中选择支持所请求模型的渠道。需要固定分组时,按第 2 步的「手动指定分组」设置。

进入 API 令牌,点击添加令牌

进入控制台左侧的API 令牌,点击添加令牌,打开左侧的“创建新的令牌”表单。

QuickRouter 控制台令牌管理页面及新建令牌入口
图 1从令牌管理页打开新建表单。

保留智能路由,选择策略

在新建令牌表单的「智能路由」区域,确认开关显示智能路由已开启,再选一种策略。

  • 智能自动(推荐) 综合价格、速度和成功率自动选择渠道。
  • 价格优先 优先选择成本较低的渠道。
  • 速度优先 优先选择响应较快的渠道。
  • 成功率优先 优先选择近期更稳定的渠道。
QuickRouter 令牌表单保持智能路由开启,四种策略中选中智能自动
图 2智能路由开启时,选择上方四种策略之一。表单下方手动选择的分组不参与路由。
需要固定线路时,手动指定分组
  1. 关闭「智能路由」,打开「分组优先级选择」。
  2. 需要固定一个分组时,只选择支持目标模型的那个分组。需要多个分组时,按优先顺序选择,也可在「当前优先级顺序」中拖拽调整。
关闭智能路由后手动选择分组并调整优先顺序
图 3手动分组的选择顺序就是优先级。分组名称、倍率和可用性以控制台为准。

请求中的模型后缀或 provider.sort 可能覆盖令牌级路由。需要固定线路时,也检查工具或应用是否发送了这些设置。

填写名称、数量与有效期

  • 名称:必填,使用容易识别用途的名称,例如 QuickRouter-Codex。
  • 数量:本教程只创建一个令牌,填写 1。
  • 过期时间:按使用期限设置,可选择永不过期、一个月、一天、一小时或月底等快捷选项。
新建令牌的过期时间快捷设置和新建数量 1
图 4选择有效期和新建数量。图中“一个月”仅作示例,到期时间由控制台自动计算。

设置额度、模型与 IP 范围

令牌额度

新建表单默认开启无限额度。需要控制这个令牌的使用上限时,关闭该开关并填写预算额度。图中填写 5,表单显示等价金额 $5.00,表示这个令牌的使用上限;可按自己的预算修改。

令牌额度是使用上限,不是充值。开启无限额度也不会增加账户余额,实际调用仍受账户余额和权限约束。

关闭无限额度后填写额度 5,控制台显示等价金额 $5.00
图 5按用途决定是否设置令牌额度上限。

模型限制与 IP 白名单

  • 模型限制:留空表示不额外限制模型,实际可用模型取决于账号权限与所用接口;只供某个工具使用时,可按需限定具体模型 ID。
  • IP 白名单:留空表示不增加 IP 限制;需要限制来源时填写允许的 IP,一行一个。本地网络出口 IP 经常变化时,先确认实际出口再设置。

Midjourney 设置:仅在使用 Midjourney 图片代理时按需调整;普通聊天或编程工具可保留“默认”。

令牌模型限制与 IP 白名单设置区域
图 6模型与 IP 限制按实际用途填写,留空含义见上方说明。

创建令牌,复制到自己的工具

  1. 提交前确认路由策略已选好。使用手动分组时,核对所选分组及优先级。再检查名称、数量、额度及有效期。
  2. 点击表单底部的提交按钮;创建成功后,在令牌管理列表找到刚才填写的名称。
  3. 在该行“密钥”栏点击复制图标,取得完整 API Key,再填入自己的工具配置。

Claude Code(终端版)、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 可通过下面两个工具配置;Claude(桌面版)等客户端可在 CC-Switch 教程中选择对应章节。

需要确认实际调用时,发送一条短文本,并在控制台核对模型、分组和消耗记录。创建成功或复制到工具后,不代表模型请求已经成功。

常见问题

智能路由选哪种策略?

首次配置推荐智能自动,综合价格、速度与成功率选择渠道。侧重成本、响应速度或近期稳定性时,分别选择价格优先、速度优先或成功率优先。

选择了分组,为什么请求没有按这个分组处理?

先检查智能路由是否已关闭。开启智能路由时,下方分组选择会被忽略;请求中的模型后缀或 provider.sort 也可覆盖令牌级路由。

一个令牌可以选择多个分组吗?

可以。关闭智能路由后选择多个分组,选择顺序就是分组优先级,也可在“当前优先级顺序”中拖拽调整。需要固定单一分组时,只保留目标分组。

无限额度表示免费或账户余额无限吗?

不是。令牌额度只是这个令牌的使用上限,不是充值金额;即使开启无限额度,调用仍受账户余额和实际权限约束。

模型限制留空,是否可以调用平台上的所有模型?

留空表示不额外限制令牌的模型范围。模型仍须在账号可访问的分组中可用,并支持所用接口。手动指定分组时,核对所选分组是否支持该模型。

复制令牌后仍提示 401 或无效令牌,先查哪里?

在 API 令牌列表按名称找到令牌,确认状态为已启用且未过期;重新用密钥栏的复制图标取得完整 API Key,替换客户端中的旧密钥。不要复制界面显示的掩码字符串。

提示额度不足或模型无权限,怎样处理?

额度不足时分别检查账户剩余额度和该令牌剩余额度。模型无权限时,核对模型 ID、账号可访问的分组和令牌的模型限制;手动指定分组时,核对所选分组是否支持该模型。

下一步

查询模型与当前分组 · 了解额度消耗与费用计算 · 排查鉴权与模型权限 · 按工具查找配置教程。

在线客服