认识分组(Group)
在 jmds.dev,每一个 API 令牌都属于一个 分组(Group)。分组决定了这个令牌 能调用哪些模型。
选错分组是新手最常见的报错来源(例如「无可用渠道」「模型不存在」),所以在创建令牌、配置工具之前,建议先花两分钟把分组搞清楚。
什么是分组
可以把分组理解为「一套模型」的集合:
- 一个令牌只属于一个分组,在创建令牌时选择。
- 不同分组的可用模型不同:有的分组里只有 Claude 系列模型,有的只有 GPT 系列模型。令牌只能调用自己所在分组里的模型。
- 不同分组的价格也可能不同,具体以控制台和 充值与额度 为准。
也就是说:同一个模型名,如果它不在你令牌所属的分组里,这个令牌就调不动它——这不是令牌坏了,而是分组不匹配。
平台上有哪些分组
下面这张表在 每次构建文档时自动从控制台同步,无需手动维护(数据来自后台的「用户可用分组」配置):
| 分组 | 用途说明 |
|---|---|
Claude Pro 按量 | 按量付费,仅允许Claude Code |
Claude 按量 | 按量付费,仅允许Claude Code |
OpenAI Pro 按量 | 按量付费,不限客户端 |
OpenAI 按量 | 按量付费,不限客户端 |
标注「仅限 Claude Code」的分组只认官方客户端
有些分组(见上表「用途说明」)里的 Claude 模型被限制为 只接受官方 Claude Code 客户端 的请求。用其他客户端、SDK 或自己写脚本直接请求会被拒绝。要用 Claude 模型做命令行编码,请按 命令行使用 安装官方 claude CLI。
创建令牌时怎么选分组
登录控制台,进入左侧 API 密钥 页面。
点击右上角 创建 API 密钥。
在弹窗里填写 名称,然后点开 分组 下拉,选择一个分组。
点击保存,复制
sk-开头的完整密钥。
完成后,你应该在 API 密钥列表里看到这个新令牌,并且它的 分组 列显示的就是你刚才选择的分组。
完整密钥只在创建时显示一次,请立即复制保存。详见 创建 API 令牌。
怎么查看现有令牌在哪个分组
进入 API 密钥 页面,列表里的 分组 列会显示每个令牌所属的分组。
如果你不确定某个令牌为什么调不动某个模型,第一步就是来这里确认它的分组。
我该选哪个分组?
按你要做的事来选:
- 用 Claude Code(命令行) → 选含 Claude 模型的分组(上表用途里注明支持 / 仅限 Claude Code 的那种)。
- 用 Codex CLI,或其他 OpenAI 兼容工具 / SDK / 代码 → 选含 GPT / OpenAI 模型、且不限客户端的分组。
- 不确定、只是想先跑通 → 对照上表「用途说明」,挑一个和你要用的模型、客户端匹配的分组。
一个令牌只对应一个分组
一个令牌只能调用它所在分组里的模型。如果你既要用 Claude Code、又要用 Codex,请 分别创建两个令牌:一个选含 Claude 模型的分组给 Claude Code,一个选含 GPT / OpenAI 模型的分组给 Codex。
常见问题
提示「无可用渠道」/ 模型不存在 / model_not_found? 多半是你填的模型名不在当前令牌所属的分组里。例如用只含 GPT 模型的分组的令牌去调用 Claude 模型,就会报「分组 … 下模型 claude-… 无可用渠道」。解决办法:把模型名换成该分组里确实有的模型,或改用一个含该模型的分组所对应的令牌。
Claude Code 一直连不上 / 被拒绝? 确认两点:① 用的令牌属于含 Claude 模型的分组;② 用的是官方
claudeCLI——这类分组只接受 Claude Code 客户端,用别的方式直接请求会被挡。配置步骤见 命令行使用。