核心概念
分组、号池、推理积分等术语的定义，以及请求被拒绝的环节。
术语
| 术语 | 含义 |
|---|---|
推理积分 🍥 | 计费单位，账户余额与订阅额度均以此计量 |
| 分组 | 一组模型的集合，具有独立的倍率和容量 |
| 倍率 | 分组作用于模型原价的系数 |
| 号池 | 分组对应的上游账号集合 |
| 作用域 | 密钥归属个人或团队，决定付款方 |
| 复合 Key | 绑定多个分组的 Key，通过前缀区分 |
分组
分组决定可用的模型、计费价格、接受的协议格式，以及承接请求的上游账号。
创建 API Key 时必须指定一个分组。普通 Key 只能绑定一个分组，需要同时使用多个分组时使用复合 Key。
倍率作用于模型原价，模型广场 显示的价格已包含倍率，即为最终扣费价格。
分组是 API Key 的属性，与账户的订阅套餐（Lite / Plus / Pro 等）无关。
Claude Max 分组仅接受 Claude Code 客户端，其他客户端会返回 403 this group only allows Claude Code clients。选择分组前请查看模型广场中的客户端限制，见 Claude Max 分组。
号池
号池是分组对应的上游账号集合。Pro 号池包含 Pro 模型，服务压力较大时访问优先级可能更高，除此之外与 Plus 号池无差异。
账号类型决定部分功能能否使用。Fast 模式 的强制开启要求命中 OpenAI 或 Anthropic 平台的账号，且 Anthropic 账号必须使用 API Key 凭据；命中 Bedrock、Vertex 或 OAuth 凭据时会静默跳过。
API Key
作用域决定付款方，创建后不可更改，在 API 密钥页面 右上角切换。
| 作用域 | 付款方 | 可选分组来自 |
|---|---|---|
| 个人 | 本人 | 本人的分组权益 |
| 团队 | 团队所有者 | 所有者的分组权益 |
普通 Key 在创建时绑定一个分组，调用时直接写模型 ID。
创建时开启 复合 Key 可绑定 1 至 20 个分组，每个分组配一个前缀，调用时以 前缀/模型 ID 指定分组。跨多个分组调用时，单个 Key 即可承载不同分组的请求。
费用计算
单次请求分输入、输出、缓存三部分计算，单价取本次请求实际命中的分组。复合 Key 按前缀命中的分组计算。
扣费顺序为先订阅后余额：优先消耗即将到期的订阅额度，没有可用订阅时扣除账户余额。
Fast 模式 使用高优先级通道，费用约为常规的 2 倍。
请求被拒绝的环节
排查失败请求时按以下顺序核对：
| 环节 | 检查什么 |
|---|---|
| 密钥 | 是否存在、被禁用、已过期；团队密钥还要求成员与所有者账号均处于正常状态，且团队未暂停 |
| 分组解析 | 复合 Key 的模型 ID 必须带前缀，且前缀在映射内，否则返回 COMPOSITE_KEY_* |
| 模型权限 | 模型是否属于该分组 |
| 接口支持 | 复合 Key 不支持 WebSocket / Realtime 类接口 |
| 额度 | 账户余额、订阅额度、团队成员的日 / 周 / 月限额，任一不足都会被拒 |
| 上游 | 通过以上检查后，请求才会发往模型服务商 |
TokenFlux 不提供 embedding 模型。
各情况对应的状态码和报错文案见 错误码。
相关入口
- 排障 — 请求失败时按症状定位
- 创建 API Key — 选择分组并生成密钥
- 计费说明 — 倍率、订阅与充值
- 复合 Key — 一个 Key 使用多个分组
- API 端点 — 客户端要填的地址