Skip to content

认识分组(Group) ​

在 jmds.dev,每一个 API 令牌都属于一个 分组(Group)。分组决定了这个令牌 能调用哪些模型。

选错分组是新手最常见的报错来源(例如「无可用渠道」「模型不存在」),所以在创建令牌、配置工具之前,建议先花两分钟把分组搞清楚。

什么是分组 ​

可以把分组理解为「一套模型」的集合:

  • 一个令牌只属于一个分组,在创建令牌时选择。
  • 不同分组的可用模型不同:有的分组里只有 Claude 系列模型,有的只有 GPT 系列模型。令牌只能调用自己所在分组里的模型。
  • 不同分组的价格也可能不同,具体以控制台和 充值与额度 为准。

也就是说:同一个模型名,如果它不在你令牌所属的分组里,这个令牌就调不动它——这不是令牌坏了,而是分组不匹配。

平台上有哪些分组 ​

下面这张表在 每次构建文档时自动从控制台同步,无需手动维护(数据来自后台的「用户可用分组」配置):

分组用途说明
default默认分组
codexOpenai号池,不限制客户端
claude-proClaude号池,仅支持claude code使用
image生图分组,不限制客户端

标注「仅限 Claude Code」的分组只认官方客户端

有些分组(见上表「用途说明」)里的 Claude 模型被限制为 只接受官方 Claude Code 客户端 的请求。用其他客户端、SDK 或自己写脚本直接请求会被拒绝。要用 Claude 模型做命令行编码,请按 命令行使用 安装官方 claude CLI。

创建令牌时怎么选分组 ​

  1. 登录控制台,进入左侧 API 密钥 页面。

  2. 点击右上角 创建 API 密钥。

  3. 在弹窗里填写 名称,然后点开 分组 下拉,选择一个分组。

  4. 点击保存,复制 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 模型的分组;② 用的是官方 claude CLI——这类分组只接受 Claude Code 客户端,用别的方式直接请求会被挡。配置步骤见 命令行使用。

下一步 ​