分组
用具体例子理解分组如何管理不同渠道的模型折扣，以及 API Key 选择分组后可用模型和价格的变化。
Toodoo AI 区分两种分组：
| 分组 | 作用 | 与 API Key 的关系 |
|---|---|---|
| 用户分组 | 用户归属、权限规则、订阅升降级和用户组优惠 | 新用户仍属于 default；不直接作为调用线路 |
| 模型分组 | 可用模型、渠道路由和调用价格 | 创建或修改密钥时选择 |
default 只用于用户归属，不出现在模型筛选和密钥选组中。用户组与模型组即使同名，也不会自动获得模型调用权限；实际可用范围由平台的明确授权及付费门槛决定。下面的“分组”均指模型分组。
分组用于定价：把不同渠道提供的模型，按照可用范围和折扣价格组织起来。 创建或编辑 API Key（API 密钥）时选择分组，就是为这枚密钥选择一套可用模型和对应的价格规则。
可以把分组理解成一张“模型价目表”：上面列着你能用哪些模型，以及使用它们要付多少钱。渠道则是提供模型服务的来源，同一个模型可能由不同渠道提供，各渠道的价格和支持的功能可能不同。一个分组可以包含多个渠道，不能仅凭分组名称判断它只有一个渠道。
同一账号下，两枚 API Key 如果选择不同分组，可用的模型以及对应折扣都可能不同。 即使在同一个客户端里、使用同一个模型名称，更换密钥后也需要重新核对分组和价格。
举个例子：为什么换了 API Key，模型和价格会变？
假设平台提供下面两组价目表。以下分组名、模型名和价格均为虚构示例，不代表当前在售模型或实际优惠。 为方便比较，假设模型 A、B 的输入基准价都是每 100 万 Token（模型处理文字的计量单位）10 元，且只比较输入费用。
| API Key 选择的分组 | 可用模型及渠道 | 示例折扣 | 示例输入单价 |
|---|---|---|---|
| 日常组 | 渠道甲的模型 A、模型 B | 八折（倍率 0.8） | A、B 均为 8 元 / 100 万输入 Token |
| 优惠组 | 渠道甲的模型 A | 六折（倍率 0.6） | A 为 6 元 / 100 万输入 Token；B 不可用 |
| 渠道乙组 | 渠道乙的模型 A | 九折（倍率 0.9） | A 为 9 元 / 100 万输入 Token |
小林给写作客户端创建了一枚选择“日常组”的 Key，给另一个工具创建了一枚选择“优惠组”的 Key：
- 调用模型 A、输入用量相同时，日常组按八折计价，优惠组按六折计价。例如只计算 100 万输入 Token，分别是 8 元和 6 元。
- 写作客户端可以选择模型 B，但换成优惠组的 Key 后，不能继续调用 B，因为优惠组没有开放它。即使钱包还有余额，也不会因此获得 B 的调用权限。
- 如果选择渠道乙组，就要使用该组提供的模型 A 的完整模型 ID，并按该渠道、该分组对应的价格计费，不能直接套用渠道甲的六折价格。
因此，选择分组时要同时看“有没有我要的模型”和“这个模型在这里多少钱”，不能只挑折扣数字最低的分组。
折扣、倍率与实际费用怎么看？
在按基准价乘倍率计价的情况下，八折就是支付基准价的 80%，也就是乘以 0.8，不是减去 80%。倍率 1 表示按该基准价计费，倍率大于 1 则表示费用高于该基准价。
以上例为例：10 元 × 0.8 = 8 元。但分组倍率的计算基础是平台配置的模型价格，不一定是模型厂商官网原价，不能把 0.8 一概理解为“官网八折”。不同渠道的基准价也可能不同，比较时应看同一币种、同一计费单位下的最终单价。
实际请求可能同时包含输入、输出、缓存等费用，也可能按图片数量、音频时长或阶梯条件计费。上表只演示输入费用，不代表整次请求的总价。请在模型价格中选择对应分组、查看目标模型的价格明细；如果页面已显示折后价格，不要再手动乘一次折扣。调用后可通过日志功能核对实际用量与消耗。
分组会影响什么？
| 影响项 | 说明 |
|---|---|
| 模型列表 | 分组可能只开放部分模型，GET /v1/models 返回的是当前密钥实际可用的列表。 |
| 协议能力 | 同一个模型名称在不同渠道中可能支持不同协议，例如 Chat Completions、Responses 或 Anthropic Messages。 |
| 折扣价格 | 同一模型在不同分组下的折扣和最终价格可能不同；不同渠道的同名模型也不能直接套用同一报价。 |
| 可用性 | 渠道状态、并发、限流和临时故障可能影响实际请求结果。 |
如何选择分组
1. 先选择模型与工具协议
在统一配置引导选择想使用的模型，应用会筛选兼容协议：Claude Code 和 Anthropic SDK 使用 Anthropic Messages，Codex 原生使用 Responses（Chat Completions 可通过 CC Switch 路由转换）。不必先逐组查找模型。
2. 对比分组中的模型和折扣价格
引导在选择或创建密钥时展示支持当前模型的分组。需要详细比较时，再在模型价格查看对应模型的输入、输出等价格明细。价格页的筛选不会修改 API Key 已绑定的分组。
3. 为 API Key 选择对应分组
在引导中直接创建匹配分组的密钥，默认名称为分组名，也可自行改名。已有密钥需要改分组时，在 API 密钥 编辑。只能使用当前账号获准使用的分组；不能在请求中填写折扣数字来改变计费。
用目标 API 密钥查询 GET /v1/models，不要用其他密钥的列表代替。复制返回的完整 id，保留渠道前缀、大小写和斜杠。
4. 用最小请求确认
先发送短文本，再验证长上下文、图片、工具调用和思考等高级能力。模型“出现在列表中”只说明它可见，不代表所有能力都已开启。
自动分组与跨组尝试
如果控制台提供 自动分组，平台会根据当前可用配置选择合适的分组；你仍需要确认模型 ID 和协议方向。若页面提供跨组重试或类似选项，它可能在一次请求失败后尝试其他可用分组，也可能带来不同的延迟、费用或结果差异。
需要稳定复现时，优先使用明确的固定分组；需要提高可用性时，再根据页面说明启用自动策略。具体可选项以当前账号和控制台显示为准。
更换分组后的检查清单
- 打开 API 密钥，确认密钥已绑定新的分组。
- 核对新分组的折扣价格，并重新查询
GET /v1/models，不要继续使用旧报价和旧模型列表。 - 在客户端重新选择模型，必要时重启客户端。
- 发送最小请求并打开日志功能，核对实际使用的模型和分组。
如果返回 403，优先检查分组和模型权限；如果返回 404，检查模型 ID 和地址是否正确；更多情况见错误码与排障。
旧密钥提示“需重新选择模型分组”
旧密钥如果保存的是 default 或空分组，仍可改名、停用和删除，但不能用于新的模型调用或获取调用模型列表。打开该密钥的分组选择，选定一个获准模型组后保存，同一枚密钥即可恢复调用，无需更换密钥字符串。原有日志与任务查询保留。
auto 是自动路由策略，不是用户分组。它仅在获准候选模型组中按顺序选择；自定义候选全部失效时不会回退到全局候选。新密钥仅在平台开启默认 auto 且存在获准候选时预选自动，否则需要明确选组。无可用组时请联系管理员配置授权。