分组管理

分组（Group）是 Code Router 控制「谁能用哪些渠道、按什么倍率计费」的核心机制。每个用户、每个令牌都归属于某个分组，而渠道则声明自己对哪些分组开放。请求进来时，系统只会在「该令牌所属分组可访问的渠道」范围内做路由，从而实现权限隔离与差异化定价。

使用管理员账号登录后，在控制台的系统设置 / 管理面板中找到「分组」入口（如 /console/setting）。分组列表展示平台已配置的所有分组名称及其计费倍率。

分组的三个落点

分组本身只是一个名称加倍率，真正生效是因为它同时出现在三处，三者匹配上才会放行：

用户分组：在用户管理页编辑用户时，为该用户指定默认所属分组。
令牌分组：创建或编辑令牌时，可为该令牌单独指定分组；不指定则继承用户分组。一次请求实际使用的是令牌分组。
渠道分组：添加渠道时，在「分组」字段填写允许访问该渠道的分组名称（可填多个）。

路由判定基于 令牌分组。某渠道只有在其「分组」字段包含当前令牌的分组时，才会成为该请求的候选渠道。

配置一个新分组

规划分组与倍率

先想清楚要区分哪些用户群体（例如内部测试、普通用户、高优先级用户），以及它们之间的计费差异。分组通过倍率体现价格差异：倍率作用于该分组下渠道的基础计费，倍率越高，等量调用扣减的配额越多。

具体倍率取值与定价策略请按实际运营方案设定（定价待补 / pricing TBD）。文档不预设任何价格数字。

在渠道上声明分组

进入「渠道」管理页，编辑目标渠道，在「分组」字段填入要开放的分组名称。一个渠道可同时对多个分组开放，多个渠道也可以共用同一分组名以实现负载与容灾。

给用户 / 令牌指定分组

在「用户」页为用户设置默认分组；如需更细粒度控制，在「令牌」页为单个令牌单独指定分组。令牌分组优先于用户分组生效。

验证路由

用属于该分组的令牌发起一次调用，确认它只命中了对该分组开放的渠道。基址与端点统一为：

curl https://ai.sammier.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{"model": "your-model", "messages": [{"role": "user", "content": "ping"}]}'

OpenAI 兼容端点为 https://ai.sammier.com/v1。

自动分组（auto）

将令牌分组设为 auto 时，系统不锁定某一个固定分组，而是按优先级顺序在多个可用分组之间自动选择一个能完成本次请求的分组。适合需要跨分组容灾、或希望优先走低成本分组、失败再回退的场景。

auto 的回退顺序取决于分组与渠道的优先级配置。建议先在少量令牌上验证回退行为符合预期，再大范围启用。

常见问题

令牌报「无可用渠道 / no available channel」：检查该令牌分组是否真的有渠道在「分组」字段中声明了它；分组名称需逐字匹配，注意大小写与空格。
同一模型不同分组价格不同：这是预期行为，由分组倍率与渠道定价共同决定（具体数值待补 / TBD）。
想临时收紧某类用户权限：把这批用户/令牌切换到一个只关联受限渠道的分组，即可在不动渠道配置的前提下快速隔离。

遇到判定不符合预期的情况，欢迎在源码仓库提交 issue 反馈：github.com/ssgzy/Router-new-api。

目录