Skip to content

认识分组(Group)

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

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

什么是分组

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

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

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

平台上有哪些分组

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

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

claude-pro 只认 Claude Code

claude-pro 分组里的 Claude 模型被限制为 只接受官方 Claude Code 客户端 的请求。用其他客户端、SDK 或自己写脚本直接请求会被拒绝。要用 Claude 模型做命令行编码,请按 命令行使用 安装官方 claude CLI。

创建令牌时怎么选分组

  1. 登录控制台,进入左侧 API 密钥 页面。
  2. 点击右上角 创建 API 密钥
  3. 在弹窗里填写 名称,然后点开 分组 下拉,选择一个分组。

「创建 API 密钥」弹窗中的「名称」和「分组」字段,分组处显示「选择一个分组」

  1. 点击保存,复制 sk- 开头的完整密钥。

完成后,你应该在 API 密钥列表里看到这个新令牌,并且它的 分组 列显示的就是你刚才选择的分组。

完整密钥只在创建时显示一次,请立即复制保存。详见 创建 API 令牌

怎么查看现有令牌在哪个分组

进入 API 密钥 页面,列表里的 分组 列会显示每个令牌所属的分组:

API 密钥列表中的「分组」列,显示令牌所属的分组名称

如果你不确定某个令牌为什么调不动某个模型,第一步就是来这里确认它的分组。

我该选哪个分组?

按你要做的事来选:

  • 用 Claude Code(命令行) → 选含 Claude 模型、且支持 Claude Code 的分组,当前是 claude-pro
  • 用 Codex CLI,或其他 OpenAI 兼容工具 / SDK / 代码 → 选含 GPT 模型的分组,当前是 codex(或 default)。
  • 不确定、只是想先跑通 → 选 default

一个令牌只对应一个分组

一个令牌只能调用它所在分组里的模型。如果你既要用 Claude Code、又要用 Codex,请 分别创建两个令牌:一个选 claude-pro 给 Claude Code,一个选 codex 给 Codex。

常见问题

  • 提示「无可用渠道」/ 模型不存在 / model_not_found? 多半是你填的模型名不在当前令牌所属的分组里。例如用 codex 分组的令牌去调用 Claude 模型,就会报「分组 codex 下模型 claude-… 无可用渠道」。解决办法:把模型名换成该分组里确实有的模型,或改用一个含该模型的分组所对应的令牌。

  • Claude Code 一直连不上 / 被拒绝? 确认两点:① 用的令牌属于支持 Claude 模型的分组(claude-pro);② 用的是官方 claude CLI——claude-pro 分组只接受 Claude Code 客户端,用别的方式直接请求会被挡。配置步骤见 命令行使用

下一步