分组是 Sub2API 权限与计费的实际边界:Key 绑/限到分组,分组决定能打哪些上游账号。官方 Composite Groups 文档给的建组范式是先建具体 provider 组(如 OpenAI Paid、Claude Paid、Gemini Paid、Grok Paid),再在上面叠路由层(条目 5)。
适用场景:团队有普通成员/核心成员、测试/生产等不同人群,需要不同模型范围与不同成本档位。
分组 权限边界 命名规范 费率
操作步骤
- 先按“平台 × 档位”建具体组(如付费池与免费/备用池分开),不要一个大组装所有账号。
- 再按人群映射:普通成员的 Key 只给便宜/够用档位的组;高端模型组只发核心成员。
- 测试与生产分开建组/Key,测试流量不要和生产共用额度池。
- 分组命名写进团队约定(平台-档位-用途),新管理员看名字就知道能不能动。
配置说明
已核验:具体 provider 组承载账号池;Composite 组可从具体组复制账号,也可从账号新建/编辑与批量账号流程把具体账号直接分配给 Composite 组。订阅类支付计划可绑定 subscription_type=subscription 的 Composite 组,但每笔请求仍按解析出的具体平台做 quota 检查与计费。⚠️ 未核验:LIN 版本后台里分组的倍率/价格字段名,不要凭 New API 的“分组倍率”叫法套写。
注意事项
- ⚠️ 全员共用一个组 = 权限、费率、故障半径全部耦合,一处改动全员受影响。
- ⚠️ 组建好后随手改成员归属,却不复测 Key 的实际可达模型范围。
来源:https://github.com/Wei-Shaw/sub2api/blob/main/docs/COMPOSITE_GROUPS.md