Composite Groups 是管理员路由层：Key 不再绑单一 provider，而是按请求的 model 解析到具体平台（Anthropic / Gemini / OpenAI / Antigravity / Grok / Kimi / Zhipu GLM / DeepSeek / MiniMax）。适合“对成员只发一个入口、背后多家模型”的团队套餐式分发。

适用场景：团队希望成员一把 Key 同时用 GPT/Claude/Gemini/Grok，且别名、计费归属还要可审计时。

Composite Groups 路由注册表 多 provider 模型别名

操作步骤

  1. 建 platform 为 composite 的分组（管理端可从分组列表的 Routes 动作配置，或走 admin API）。
  2. 把 provider 账号直接分配给 Composite 组，或建组时从具体组复制账号。
  3. 为不应依赖内置识别的公共别名加显式 route（官方示例：all/gpt-5 → responses → openai → gpt-5；all/claude-sonnet → messages → anthropic；all/gemini-pro、all/grok 同理）。
  4. 到具体平台下配 channel 的定价与模型映射（Composite 路由本身不生成定价记录）。
  5. 用 preview 接口/动作预览解析结果再上线。

配置说明

已核验的 admin API（文档原文）：GET/POST /api/v1/admin/groups/:id/composite-routes、PUT/DELETE.../:route_id、POST.../preview。Route 字段：public_model、match_type（exact/prefix）、target_platform、upstream_model（省略则沿用 public model）、endpoint、priority、enabled。解析顺序：显式路由优先于内置识别；exact 胜 prefix，endpoint 专用胜 any，长前缀胜短前缀，再比 priority 与 route id。内置识别示例：claude-*→Anthropic、gpt-*/o*/codex-*→OpenAI、gemini-*→Gemini、grok-*→Grok、glm-*→Zhipu、deepseek-*→DeepSeek 等；未知/歧义模型名 fail closed 报客户端错误，不猜 provider。

注意事项

  • ⚠️ 以为 Composite 会自动生成模型元数据/定价/上游能力记录——文档明确说不会，具体平台侧没配好就是调不通。
  • ⚠️ 文档明确未实现的能力不要宣传：没有“按任务在多 provider 间 AUTO 智能选路”，也没有“不建 Composite 组就让一把 Key 直绑多个现有组”。

来源：https://github.com/Wei-Shaw/sub2api/blob/main/docs/COMPOSITE_GROUPS.md