管理员指南

分组管理

分组用于隔离不同用户的渠道访问权限和计费倍率

分组是连接用户、令牌与渠道的纽带：用户只能使用与其分组匹配的渠道；不同分组可配置不同的计费倍率（group_ratio）。管理员通过 `GET /api/group/` 查看分组列表，使用 `prefill_group` 接口维护分组名称与倍率。Web 控制台页面与参考设计一致，正在对接中。

分组的使用方式

分组贯穿用户、令牌与渠道三层配置，共同决定「谁能用哪些渠道、按什么倍率计费」：

编辑用户时指定所属分组（user.group）。用户只能使用与其分组匹配的渠道；模型广场与定价也会按用户分组展示可用模型与倍率。

相关字段：user.group · 详见用户管理

创建或编辑令牌时指定渠道分组（token.group）。API 调用按令牌分组匹配 channel.group 与 ability 表路由；可开启「跨分组重试」在首选分组无可用渠道时尝试其他分组。

相关字段：token.group · 详见令牌管理

令牌分组设为 `auto` 时，系统按优先级顺序自动选择一个可用分组，适合需要跨分组容灾的场景。

添加或编辑渠道时设置分组（channel.group，默认 default）。仅当用户/令牌分组与渠道分组一致时，该渠道才会参与路由。

相关字段：channel.group · 详见渠道管理

通过预填充分组接口维护分组名称与计费倍率；`GET /api/pricing` 返回的 group_ratio 会反映到模型广场的分组筛选与倍率标识。

字段	说明
`name` · 分组名称	如 default、vip、test；与 user / token / channel 的 group 字段对应
`ratio / group_ratio` · 计费倍率	相对基准价格的倍数，模型广场与 pricing 接口展示为如 1.5x
`description` · 说明	可选，便于管理员识别用途

接口	说明
`GET /api/group/`	获取系统已有分组及倍率
`GET\|POST\|PUT\|DELETE /api/prefill_group/`	创建、更新、删除分组定义
`GET /api/user/groups`	无需登录，供注册或展示使用