跳转到主要内容

工作原理

分组是 AIOHub 的核心路由机制。当你发送 API 请求时,AIOHub 会识别 API 令牌所属分组,根据分组配置和请求中的模型名称选择上游渠道,再将请求转发到选定渠道。 一个 API 令牌可以关联多个分组。创建 API 令牌时可以选择 auto,让网关按当前配置选择可用具体分组;需要固定某类路由时再选择具体分组,例如 codexanthropicgeminiopensource-economy

分组的作用

  • 模型可用性:不同分组可访问不同的模型集合
  • 渠道路由:同一模型在不同分组中可能走不同的上游渠道
  • 价格差异:同一模型在不同分组中可能有不同倍率
  • 稳定性auto 和跨分组重试可以在可用渠道之间切换

使用建议

1

查看可用分组

在控制台查看当前可用的分组列表及各分组支持的模型。
2

按用途分配

为不同工具创建不同 API 令牌。例如 Codex CLI 使用 codexcodex-passthrough,Gemini CLI 使用 gemini,Claude Messages 客户端使用 anthropic 或 Claude 专用分组。
3

测试可用性

创建 API 令牌后,调用 /v1/models 接口确认可用模型列表符合预期。

注意事项

  • API 令牌的分组可以在控制台或 API 令牌管理接口中更新;更新后旧客户端无需更换 sk-
  • 分组配置可能会根据上游供应商变化而调整
  • auto 是路由控制值,不是固定具体分组;开启 auto 或跨分组重试时,实际路由仍受当前分组可见模型、渠道状态和余额影响