管理员指南
分组管理
分组用于隔离不同用户的渠道访问权限和计费倍率
分组用于隔离不同用户的渠道访问权限和计费倍率,不同分组的用户只能使用分配给该分组的渠道。使用管理员账号登录后,在系统设置或管理面板中找到「分组」入口。
分组列表展示平台所有已配置的真实分组名称。用户、API Key 路由和渠道都会引用这些分组;自动路线则把多个真实分组组合成可复用的有序链。
分组的使用方式
- 用户分组:在用户管理页编辑用户时,可为用户指定所属分组
- API Key 路由:创建或编辑 API Key 时,可选择自动路线或配置最多 8 个有序手工分组
- 渠道分组:添加渠道时可在「分组」字段填写允许访问该渠道的分组名称
自动路线链
访问 系统设置 -> 计费 -> 分组定价,或直接打开 /system-settings/billing/group-pricing。在「自动路线链」中可以创建 auto、auto:fast、auto:cheap 等命名路线:
- 路线 key 必须使用自动路线格式,路线内只能填写真实计费分组。
- 按实际尝试顺序排列分组;API Key 编辑器会展示这条分组链。
- Enabled 控制路线是否可在运行时使用;默认路线必须保持启用。
- User selectable 控制路线是否出现在新建或编辑 API Key 的可选列表中。关闭后,已保存的 API Key 仍可显示并保留该路线,但用户不能重新选择它。
- 可将任意已启用路线设为默认路线。新建 API Key 默认使用该路线和跨分组重试。
GET /api/group 的 auto_routes 只返回当前用户可选择的路线及其分组顺序。运行时会把自动路线和手工路线统一解析为有序分组计划;是否在失败后推进到下一分组,由每个 API Key 的「跨分组重试」开关决定。
将路线设为不可选适合停止新增使用,同时保留已有 API Key。直接禁用或删除正在使用的路线可能使请求失败;调整前应先检查现有 Token,并在测试环境验证模型列表、Affinity 和跨分组重试。
这篇文档对您有帮助吗?