分组与倍率

倍率（Multiplier）是平台的定价分层手段。最终费用是基础 token 费用乘以一系列倍率得到的。

倍率的种类

倍率	配置位置	作用对象
分组倍率	分组本身	属于该分组的用户
渠道-分组倍率	渠道 × 分组	该分组用户走该渠道时
模型配置-分组倍率	模型配置 × 分组	该分组用户用该模型配置时
渠道倍率	渠道	命中该渠道的所有请求
用户渠道倍率	用户渠道	命中该用户渠道的请求

最终费用公式

最终费用 = 基础 token 费用 × 有效分组倍率 × 用户渠道倍率

（渠道自身的倍率字段也参与定价分层，具体叠加以计费实现为准，详见 计费体系。）

分组（Group）

• 每个分组有一个名字和一个默认倍率（默认 1.0）；
• 用户有一个主分组（GroupID），也可以通过 分组成员关系（UserGroupMembership） 同时属于多个分组，成员关系还可带到期时间；
• 倍率 < 1 表示优惠，> 1 表示加价。

管理操作：

操作	接口
列表	GET /groups
创建	POST /groups
更新	PUT /groups/:id
删除	DELETE /groups/:id

有效分组倍率是怎么算的

当一个用户属于多个分组时，平台对每个分组计算它的「这次请求适用倍率」，再按模式合并成一个有效分组倍率：

单个分组的倍率取值（覆盖优先级）

对每个分组，按以下优先级取倍率，后者覆盖前者：

1. 分组默认倍率；
2. 若存在「渠道 × 分组」倍率（非零），用它覆盖；
3. 若存在「模型配置 × 分组」倍率（非零），用它覆盖。

即：模型配置级 > 渠道级 > 分组默认。倍率为 0 视为「未设置」，不参与覆盖。

多分组合并模式

得到每个分组的倍率后，按系统设置 group_multiplier_mode 合并：

模式	行为
min（默认，含未识别值）	取所有分组倍率中的最小值（对用户最有利）
max / high / higher	取最大值

只属于一个分组（或只有默认主分组）时，结果就是那个分组的倍率；没有任何分组时，倍率为 1.0。

配置实例

目标：VIP 用户在「高速」渠道上享受 8 折。

1. 建分组 vip，默认倍率 1.0；
2. 给「高速」用户渠道下的渠道设置「渠道 × vip 分组」倍率 0.8；
3. 把目标用户加入 vip 分组。

这样 VIP 走高速渠道时按 0.8 计费，走其他渠道仍按各自规则。

TIP

合并模式选 min 对用户更友好（多重身份取最优惠），选 max 更保守（取最高价）。根据你的商业策略选择。