# 核心概念

分组、号池、推理积分等术语的定义，以及请求被拒绝的环节。

## 术语

| 术语          | 含义                                   |
| ------------- | -------------------------------------- |
| 推理积分 `🍥` | 计费单位，账户余额与订阅额度均以此计量 |
| 分组          | 一组模型的集合，具有独立的倍率和容量   |
| 倍率          | 分组作用于模型原价的系数               |
| 号池          | 分组对应的上游账号集合                 |
| 作用域        | 密钥归属个人或团队，决定付款方         |
| 复合 Key      | 绑定多个分组的 Key，通过前缀区分       |

## 分组

分组决定可用的模型、计费价格、接受的协议格式，以及承接请求的上游账号。

创建 API Key 时必须指定一个分组。普通 Key 只能绑定一个分组，需要同时使用多个分组时使用[复合 Key](https://docs.tokenflux.dev/docs/tokenflux/composite-key.md)。

倍率作用于模型原价，[模型广场](https://tokenflux.dev/models) 显示的价格已包含倍率，即为最终扣费价格。

分组是 API Key 的属性，与账户的订阅套餐（Lite / Plus / Pro 等）无关。

`Claude Max` 分组仅接受 `Claude Code` 客户端，其他客户端会返回 403 `this group only allows Claude Code clients`。选择分组前请查看模型广场中的客户端限制，见 [Claude Max 分组](https://docs.tokenflux.dev/docs/agents/claude-code.md#claude-max-分组)。

## 号池

号池是分组对应的上游账号集合。`Pro` 号池包含 Pro 模型，服务压力较大时访问优先级可能更高，除此之外与 `Plus` 号池无差异。

账号类型决定部分功能能否使用。[Fast 模式](https://docs.tokenflux.dev/docs/tokenflux/fast-mode.md) 的强制开启要求命中 OpenAI 或 Anthropic 平台的账号，且 Anthropic 账号必须使用 API Key 凭据；命中 Bedrock、Vertex 或 OAuth 凭据时会静默跳过。

## API Key

**作用域**决定付款方，创建后不可更改，在 [API 密钥页面](https://tokenflux.dev/keys) 右上角切换。

| 作用域 | 付款方     | 可选分组来自     |
| ------ | ---------- | ---------------- |
| 个人   | 本人       | 本人的分组权益   |
| 团队   | 团队所有者 | 所有者的分组权益 |

普通 Key 在创建时绑定一个分组，调用时直接写模型 ID。

创建时开启 [复合 Key](https://docs.tokenflux.dev/docs/tokenflux/composite-key.md) 可绑定 1 至 20 个分组，每个分组配一个前缀，调用时以 `前缀/模型 ID` 指定分组。跨多个分组调用时，单个 Key 即可承载不同分组的请求。

## 费用计算

单次请求分输入、输出、缓存三部分计算，单价取本次请求实际命中的分组。复合 Key 按前缀命中的分组计算。

扣费顺序为先订阅后余额：优先消耗即将到期的订阅额度，没有可用订阅时扣除账户余额。

[Fast 模式](https://docs.tokenflux.dev/docs/tokenflux/fast-mode.md) 使用高优先级通道，费用约为常规的 2 倍。

## 请求被拒绝的环节

排查失败请求时按以下顺序核对：

| 环节     | 检查什么                                                                             |
| -------- | ------------------------------------------------------------------------------------ |
| 密钥     | 是否存在、被禁用、已过期；团队密钥还要求成员与所有者账号均处于正常状态，且团队未暂停 |
| 分组解析 | 复合 Key 的模型 ID 必须带前缀，且前缀在映射内，否则返回 `COMPOSITE_KEY_*`            |
| 模型权限 | 模型是否属于该分组                                                                   |
| 接口支持 | 复合 Key 不支持 WebSocket / Realtime 类接口                                          |
| 额度     | 账户余额、订阅额度、团队成员的日 / 周 / 月限额，任一不足都会被拒                     |
| 上游     | 通过以上检查后，请求才会发往模型服务商                                               |

TokenFlux 不提供 embedding 模型。

各情况对应的状态码和报错文案见 [错误码](https://docs.tokenflux.dev/docs/errors.md)。

## 相关入口

- [排障](https://docs.tokenflux.dev/docs/troubleshooting.md) — 请求失败时按症状定位
- [创建 API Key](https://docs.tokenflux.dev/docs/tokenflux/create-apikey.md) — 选择分组并生成密钥
- [计费说明](https://docs.tokenflux.dev/docs/tokenflux/billing.md) — 倍率、订阅与充值
- [复合 Key](https://docs.tokenflux.dev/docs/tokenflux/composite-key.md) — 一个 Key 使用多个分组
- [API 端点](https://docs.tokenflux.dev/docs/tokenflux/endpoints.md) — 客户端要填的地址