Group Management

TT API 的「分组」（Group）功能把同一账户下的流量、额度、可用模型分给不同项目或团队成员，常见用法是 dev / prod 分组或按团队成员拆分。本文讲清楚分组怎么建、怎么分配额度、怎么按分组看用量。

什么时候需要分组

下面任意一种场景都建议启用分组：

• 多个项目：网站 A、网站 B、内部工具 C 想分别看消耗、分别限额
• 生产 vs 测试：避免测试环境疯狂调用把生产预算吃光
• 团队协作：每个成员独立 Key + 独立配额，不互相影响
• 客户分账：你做的是 to-B 业务，需要按客户算消耗给账单

没有这些需求的话，单分组（default）就够，不必折腾。

分组能解决什么

• 独立计费：每个分组消耗单独统计，账单清晰
• 独立限额：组级别的总额上限和 RPM 上限
• 独立模型权限：组 A 只能用 GPT-5.5，组 B 全开
• 独立倍率：管理员可以给不同分组设置不同的折扣倍率（如 VIP 客户 0.8 倍）

创建分组

需要管理员权限。进入控制台 → 系统设置 → 用户分组管理：

1. 点「+ 新建分组」
2. 填字段：
   • 分组名（英文 slug）：如 team-a、prod、customer-acme
   • 显示名：友好显示用，如「团队 A」
   • 倍率：1.0 = 原价；< 1.0 = 折扣；> 1.0 = 加价
   • 可用模型：白名单，留空 = 全部
3. 保存

把 Key 分配到分组

两种方式：

方式 1：创建 Key 时指定 新建 API Key 表单里有"所属分组"下拉，选目标分组即可。

方式 2：把已有用户加入分组 进入「用户管理」→ 点击某用户 → 编辑「所属分组」→ 选目标分组。该用户名下所有 Key 自动归属新分组。

注意：一个用户同时只能属于一个分组。换分组后历史日志保留原分组，只影响后续调用。

组级别的额度

在「用户分组管理」点开某分组的「编辑」：

• 总额度（美元等值）：分组所有 Key 加起来的累计上限
• 每分钟请求数（RPM）：分组级别的 QPS 限制
• 每天请求数（RPD）：日级别上限

任一上限触达，分组下所有 Key 都会被限流，返回 429。

实战示例：to-B SaaS 分账

假设你做了一个工具卖给 3 个客户：

default        ← 你自己开发用
customer-acme  ← 客户 Acme，限额 $500/月，倍率 1.2（加价 20% 当作毛利）
customer-bcd   ← 客户 BCD，限额 $300/月，倍率 1.15
customer-xyz   ← 客户 XYZ，限额 $1000/月，倍率 1.0（VIP）

每月去仪表盘按分组拉数据，乘倍率就是给客户开的账单。

常见问题

Q：能给同一把 Key 分配多个分组吗？ A：不能。Key 是用户级别的，用户只属于一个分组。

Q：换分组后历史日志会迁移吗？ A：不会。历史日志保留发生调用时的分组归属，便于审计。

Q：default 分组能删除吗？ A：不能。它是兜底分组，新用户默认进入。可以编辑它的倍率和限额，但不能删。