> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiohub.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 分组机制

> 了解分组如何影响 API 令牌的模型访问、路由和计费。

## 工作原理

分组是 AIOHub 的核心路由机制。当你发送 API 请求时，AIOHub 会识别 API 令牌所属分组，根据分组配置和请求中的模型名称选择上游渠道，再将请求转发到选定渠道。

一个 API 令牌可以关联多个分组。创建 API 令牌时可以选择 `auto`，让网关按当前配置选择可用具体分组；需要固定某类路由时再选择具体分组，例如 `codex`、`anthropic`、`gemini` 或 `opensource-economy`。

## 分组的作用

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

## 使用建议

<Steps>
  <Step title="查看可用分组">
    在控制台查看当前可用的分组列表及各分组支持的模型。
  </Step>

  <Step title="按用途分配">
    为不同工具创建不同 API 令牌。例如 Codex CLI 使用 `codex` 或 `codex-passthrough`，Gemini CLI 使用 `gemini`，Claude Messages 客户端使用 `anthropic` 或 Claude 专用分组。
  </Step>

  <Step title="测试可用性">
    创建 API 令牌后，调用 `/v1/models` 接口确认可用模型列表符合预期。
  </Step>
</Steps>

## 注意事项

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