分组与模型

什么是分组？

分组（Group）是 GoodCode 中最核心的概念：每个 API Key 必须绑定一个分组，分组决定了两件事：

1. 平台路由 —— 这个 Key 的请求会被转发到哪个上游平台（Claude / OpenAI / Gemini / Antigravity）
2. 计费倍率 —— 实际扣费 = 模型官方价格 × 分组倍率，不同分组倍率可能不同

同一个账号可以创建多个 Key，分别绑定不同分组，从而同时使用 Claude Code、Codex、Gemini CLI。

如何查看可用分组与倍率？

后台路径：

登录后台 -> API 密钥 -> 创建密钥 -> 分组下拉框

操作步骤：

1. 进入后台，打开 API 密钥 页面
2. 点击 创建密钥
3. 展开 分组 下拉框
4. 查看每个分组的名称、平台类型和倍率说明
5. 选择与你要使用的客户端匹配的分组后再创建 Key

部分订阅套餐会绑定专属分组，购买或兑换成功后才会出现在列表中。如果找不到预期分组，先确认套餐或兑换码是否已生效。

渠道状态监控

左侧菜单 可用渠道 中可以查看各渠道的实时可用状态，遇到调用异常时可先来这里确认是否为渠道波动。

查看顺序建议如下：

可用渠道 -> 选择平台类型 -> 查看渠道状态 -> 再回到客户端重试

如果某个平台的可用渠道正在波动，可以临时切换到同平台的其他可用分组，或稍后重试。若后台渠道正常但客户端仍失败，再检查 Key 分组、模型名称和请求端点。

如何查看可用模型？

配好 Key 之后，可以直接通过 API 查询当前 Key（所属分组）下可用的模型列表：

Claude / OpenAI 分组

curl https://goodcode.store/v1/models \
  -H 'Authorization: Bearer sk-你的ApiKey'

Gemini 分组

curl https://goodcode.store/v1beta/models \
  -H 'x-goog-api-key: sk-你的ApiKey'

Antigravity 分组

curl https://goodcode.store/antigravity/models \
  -H 'Authorization: Bearer sk-你的ApiKey'

相关信息

返回的模型列表由 Key 所属分组的平台决定。如果你想确认某个模型能不能用，直接调用上面的接口看返回结果最准确。

如何判断分组是否选对？

可以用“客户端、端点、鉴权头”三项一起判断：

要使用的工具	Key 分组类型	测试端点	鉴权方式
Claude Code	Claude / Anthropic	/v1/models	Authorization: Bearer sk-...
Codex CLI	OpenAI	/v1/models	Authorization: Bearer sk-...
Gemini CLI	Gemini	/v1beta/models	x-goog-api-key: sk-...
Antigravity	Antigravity	/antigravity/models	Authorization: Bearer sk-...

如果端点能返回模型列表，但客户端调用失败，优先检查客户端配置中的 Base URL 是否与对应协议匹配，以及模型名称是否来自当前分组返回的列表。

常见客户端 Base URL 对照：

客户端 / 场景	Base URL
Claude Code（Claude 分组）	https://goodcode.store
Codex CLI（OpenAI 分组）	https://goodcode.store/v1
Gemini CLI（Gemini 分组）	https://goodcode.store
CherryStudio（OpenAI 提供商）	https://goodcode.store/v1
OpenCode（Claude 分组）	https://goodcode.store/v1
OpenCode（OpenAI 分组）	https://goodcode.store/v1
OpenCode（Gemini 分组）	https://goodcode.store/v1beta
Antigravity（Claude Code / Gemini CLI）	https://goodcode.store/antigravity
Antigravity（OpenCode）	https://goodcode.store/antigravity/v1 或 https://goodcode.store/antigravity/v1beta

常用模型参考

以下为各平台常见可用模型（以 /v1/models 实际返回为准）：

平台	常用模型示例
Claude	claude-sonnet-4-5、claude-opus-4-5 等 Claude 全系列
OpenAI (Codex)	gpt-5.5、gpt-5.2、gpt-5.3-codex 等
Gemini	gemini-2.5-pro、gemini-2.5-flash、gemini-3-pro-preview 等
Antigravity	Claude 系列 + Gemini 系列（走 /antigravity 端点）

注意

模型可用性与命名以站点实际返回为准，本表仅作参考。如果调用提示模型不可用，先确认 Key 分组类型是否正确。