创建指定分组的令牌（API Key）
在 apizt 控制台创建 API Key，指定模型分组，再交给配置工具或自己的应用使用。
进入 apizt 控制台，登录自己的账号。创建前可先在 模型价格页确认目标模型 ID、调用协议及支持的分组。配图中的红框和红字标出要填写或留意的位置，点击图片可在页内放大。
先选清楚：指定分组还是智能路由
| 使用方式 | 表单怎么设置 | 请求如何选择 |
|---|---|---|
| 指定分组 | 关闭智能路由，选择需要的分组 | 采用所选分组；多选时，选择顺序就是优先级 |
| 智能路由 | 开启智能路由，选择路由策略 | 采用智能自动、价格优先、速度优先或成功率优先策略；忽略下方分组选择 |
本教程要创建指定分组的令牌：新建表单的智能路由默认开启，必须先关闭，再选择分组。请求中的模型后缀或 provider.sort 可覆盖令牌级路由；需要固定分组时，也检查客户端是否携带这些设置。
进入 API 令牌，点击添加令牌
进入控制台左侧的API 令牌，点击添加令牌，打开左侧的“创建新的令牌”表单。
关闭智能路由，选择指定分组
- 找到智能路由开关，先将它关闭。
- 在分组优先级选择区域打开分组选择框，选择目标模型支持的分组。
- 只想使用一个分组时，只选择该分组；需要多个分组时，按优先顺序逐个选择，并在“当前优先级顺序”中检查排序；也可以拖拽调整顺序。
分组决定令牌可以使用的模型和服务范围。以你账号的分组选项与价格页当前信息为准，不同工具需要的协议也要分别确认。
填写名称、数量与有效期
- 名称：必填，使用容易识别用途的名称，例如
tokenba-Codex。 - 数量：本教程只创建一个令牌，填写
1。 - 过期时间：按使用期限设置，可选择永不过期、一个月、一天、一小时或月底等快捷选项。
设置额度、模型与 IP 范围
令牌额度
新建表单默认开启无限额度。需要控制这个令牌的使用上限时，关闭该开关并填写预算额度。图中填写 5，表单显示等价金额 $5.00，表示这个令牌的使用上限；可按自己的预算修改。
令牌额度是使用上限，不是充值。开启无限额度也不会增加账户余额，实际调用仍受账户余额和权限约束。
模型限制与 IP 白名单
- 模型限制：留空表示不额外限制模型，但仍受分组权限约束；只供某个工具使用时，可按需限定具体模型 ID。
- IP 白名单：留空表示不增加 IP 限制；需要限制来源时填写允许的 IP，一行一个。本地网络出口 IP 经常变化时，先确认实际出口再设置。
Midjourney 设置：仅在使用 Midjourney 图片代理时按需调整；普通聊天或编程工具可保留“默认”。
创建令牌，复制到自己的工具
- 提交前确认：智能路由已关闭、目标分组已选好、名称与数量正确，额度及有效期符合使用安排。
- 点击表单底部的提交按钮；创建成功后，在令牌管理列表找到刚才填写的名称。
- 在该行“密钥”栏点击复制图标，取得完整 API Key，再填入自己的工具配置。
Claude Code（终端版）、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 可通过下面两个工具配置；Claude（桌面版）等客户端可在 CC-Switch 教程中选择对应章节。
- apizt Switch 一键配置工具（新手推荐）：输入令牌，选择工具与模型，完成本地配置。
- CC-Switch 配置教程（图文）：按工具独立查看配置步骤和配图。
需要确认实际调用时，发送一条短文本，并在控制台核对模型、分组和消耗记录。创建成功或复制到工具后，不代表模型请求已经成功。
常见问题
选择了分组，为什么请求没有按这个分组处理？
先检查智能路由是否已关闭。开启智能路由时，下方分组选择会被忽略；请求中的模型后缀或 provider.sort 也可覆盖令牌级路由。
一个令牌可以选择多个分组吗？
可以。关闭智能路由后选择多个分组，选择顺序就是分组优先级，也可在“当前优先级顺序”中拖拽调整。需要固定单一分组时，只保留目标分组。
智能路由有哪些策略？
新建表单提供智能自动、价格优先、速度优先、成功率优先四种策略。启用智能路由后，下方分组选择不参与路由。
无限额度表示免费或账户余额无限吗？
不是。令牌额度只是这个令牌的使用上限，不是充值金额；即使开启无限额度，调用仍受账户余额和实际权限约束。
模型限制留空，是否可以调用平台上的所有模型？
留空表示不额外限制令牌的模型范围，但模型仍须获得所选分组授权，并支持所用接口。模型 ID 和当前分组可在价格页核对。
复制令牌后仍提示 401 或无效令牌，先查哪里？
在 API 令牌列表按名称找到令牌，确认状态为已启用且未过期；重新用密钥栏的复制图标取得完整 API Key，替换客户端中的旧密钥。不要复制界面显示的掩码字符串。
提示额度不足或模型无权限，怎样处理？
额度不足时分别检查账户剩余额度和该令牌剩余额度；固定限额令牌可能先耗尽自身额度。模型无权限时，核对模型 ID、所选分组支持范围及令牌的模型限制列表，再按对应错误页处理。
下一步
查询模型与当前分组 · 了解额度消耗与费用计算 · 排查鉴权与模型权限 · 按工具查找配置教程。