资源组

资源组由同一工作空间内的订阅账号和 API 渠道组成。需要让成员使用不同资源或模型时，可以创建多个资源组。资源和组不能跨工作空间关联。

资源类型与路由

资源组统一绑定客户端密钥、成员权限和模型白名单。编辑时分别选择 订阅账号 与 API 渠道；两类资源使用各自的管理页面，保持原有工作空间隔离。

新建资源组默认 订阅优先，并关闭 订阅不可用时允许转到 API 渠道。混合组仅在显式启用回退后，才会为没有可用订阅的新请求选择 API。仅选择 API 渠道的资源组直接使用其渠道。还可选择 API 渠道优先，或 按客户端协议优先。API 调用可能消耗上游余额；SubLane 不提供该余额查询。

升级保留旧资源组的原有协议优先策略和密钥绑定。已有会话不会因优先顺序变化自动迁移；关闭回退、移除资源或停用资源后，相关已有会话可能失败，并保持原资源身份。

管理接口保留 /api/groups 和兼容的 account_ids。新版界面发送 resources（kind: "subscription" 或 "channel"，以及资源 id）和 routing（preference 与 allow_api_fallback）。混用两种成员格式、重复 ID 和类型不符的资源会被拒绝。

管理员操作

1. 在当前工作空间打开资源组，新建资源组并选择订阅账号。新导入的账号保持未分配，加入资源组后才会参与调度。
2. 打开成员管理，直接授权每位成员可使用的资源组。没有人员组；新成员和新资源组都不会自动获得授权。
3. 成员为获授权且已启用的资源组创建个人 Key。Key 创建后永久绑定该工作空间和资源组；需要更换时应撤销旧 Key 并创建新 Key。

未设置用量分配的资源组可以在同一个工作空间内共享上游账号。用量分配要求专用资源组：请先把相关账号从其他池移除。添加用量分配后，资源组的账号成员关系会固定，即使暂停也不会解除。停用池或撤销成员授权会阻止后续请求和 WebSocket 回合，不会把已有会话悄悄转到其他账号。

每个工作空间最多支持 32 个资源组，每池最多关联 100 个账号。资源组可以重命名、停用，目前界面不提供删除操作。成员请求限制和用量分配分别配置。

包含演示账号的资源组表单：

请求与会话

• 创建 Key 时，会在同一事务内检查成员和资源组权限。
• 每次请求及每个 WebSocket 回合都会重查工作空间、成员、Key、资源组与模型策略。
• 模型发现与推理只使用 Key 绑定资源组中符合条件的资源；账号必须有支持该模型的有效目录。
• 会话亲和按成员、资源组和客户端会话保存。原资源不可用或移出资源组时，会话失败，不会自动切换资源。
• 已经开始的请求可能正常结束；授权变更会影响下一次请求或回合。

模型白名单

在资源组编辑器开启限制允许的模型后，每行填写一个精确模型 ID，最多 100 个。使用模型目录中的原生 ID；不支持通配符，模型变体需要明确列出。默认不限制模型。开启限制但留空列表会拒绝所有模型。 自动发现不会覆盖策略。被拒绝的模型返回 403 model_not_allowed，不会消耗成员请求限额。

接口参考

管理接口要求当前工作空间的管理员角色。浏览器修改请求还需通过同源检查。

网关根据已验证 Key 的绑定确定工作空间，不采信浏览器的空间选择头。另见工作空间和 API Key。