文档快速开始基础知识
分组是什么
理解 MoleAPI 分组与模型可用性、价格策略、稳定性之间的关系
在 MoleAPI 里，分组 可以理解为“某个 API Key 走哪一套模型通道与价格策略”。
它不是一个纯展示字段，而是会直接影响：
- 这个 Key 能看到哪些模型
- 调用这些模型时走哪类通道
- 对应的价格策略
- 某些情况下的稳定性与适用场景
为什么要有分组
如果平台把所有模型、所有价格、所有通道都混在一起，用户很难按用途做区分。
分组的存在，就是为了让你能把不同目标拆开管理，例如：
- 测试环境和生产环境走不同分组
- 成本敏感的流量走更便宜的组
- 稳定性优先的流量走更稳的组
- 某些特定模型只允许特定 Key 使用
你可以把分组理解成什么
一个更贴近实际的理解是：
分组 = 模型集合 + 通道策略 + 价格策略 的组合
所以即使是同一个模型，在不同分组下，也可能出现：
- 可用性不同，切换分组会导致模型不可用
- 单价不同，部分有折扣
- 稳定性体验不同，例如 relay 分组稳定性可能较差
在控制台定价页的左侧筛选里选择「可用令牌分组」，即可查看该分组下可见的模型列表。
常见分组类型
以下是文档里最常见、也最容易理解的几类：
| 分组类型 | 特点 | 适合场景 |
|---|---|---|
default | 默认分组，通常更稳、更通用 | 正式项目、长期使用 |
discount | 活动或优惠分组 | 成本敏感、愿意关注活动变化 |
relay | 价格通常更低，但体验可能更依赖具体通道 | 测试、实验、对成本更敏感的场景 |
实际以控制台和系统公告中的当前分组信息为准。
新手应该怎么选
如果你是第一次接入，建议：
- 先用默认分组 跑通流程
- 跑通后再根据价格、模型覆盖和稳定性做调整
这是因为对新手来说，先成功比先极限省钱更重要。
什么时候要认真区分分组
下面这些场景，建议你明确规划分组：
1. 生产和测试分离
不要让测试流量和正式业务混在同一策略里。
2. 想控制成本
如果你对价格很敏感，分组会是非常重要的调节手段。
3. 不同系统权限不同
例如：
- 内部实验项目可以使用较便宜的分组
- 正式产品只开放少数稳定模型
4. 你想观察不同通道效果
有时同一模型在不同分组下的体验会不同，适合先小流量测试，再决定长期策略。
分组和 API Key 的关系
分组通常是配置在 API Key 上的。创建或编辑 API Key 时，在「令牌分组」处选择该 Key 所属分组（如 default、discount、relay），不同分组对应不同倍率与模型范围。
这意味着：
- 不同 Key 可以走不同分组
- 同一个账号可以同时拥有多种策略
- 你可以按项目或环境分配不同 Key，再给它们配置不同分组
这也是为什么我们常常建议：
- 一个测试 Key
- 一个正式 Key
- 必要时每个系统各自一个 Key
使用建议
推荐做法
- 新手先用
default - 按环境拆分多个 Key
- 重要业务先稳定，再考虑更便宜的分组
- 上线前在目标分组里先做实际测试
不推荐做法
- 所有项目共用一个 Key 和一个分组
- 对分组不了解时，直接把生产流量切到陌生分组
- 只看价格，不看模型可用性和稳定性
一句话建议
先用默认分组跑通，再按成本、模型和稳定性需求做分组优化。
下一步看什么
这篇文档对您有帮助吗？
最后更新于