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

# 用量、费用与限流

> 了解分组定价与 Token 计费，查看用量并管理并发。

在 APIONE 控制台核对请求用量与费用。API 响应的 `usage` 可用于观测 Token 消耗，实际费用以平台用量记录及账单为准。

## 查看消耗

进入[控制台](https://apione.ai/zh/app)的用量页面，按界面提供的时间范围、密钥或模型筛选。公开说明包含趋势与请求明细视图，可用请求 ID 定位调用。展示字段与刷新时效以当前控制台为准。

![APIONE 用量页面请求明细](https://mintcdn.com/apione/pAFvFGkbmcRZirTZ/images/ui/request-logs.png?fit=max\&auto=format\&n=pAFvFGkbmcRZirTZ\&q=85\&s=093db383e228008dc3c42cb6a7849d28)

请求明细可以按时间、来源、API Key 和请求 ID 筛选，并查看状态、耗时、Token 与费用。

## 理解 Token 与费用

Chat 响应通常包含 prompt\_tokens、completion\_tokens 和 total\_tokens。部分模型提供缓存用量明细。不同模型可能采用不同输入、输出、缓存或媒体计费方式，不能把总 Token 简单乘以单一价格。

> [!NOTE]
>
> 模型价格、币种、充值方式、最低金额、退款规则及缓存优惠，均以当前模型详情、控制台和正式条款为准。价格以当前公布信息为准；积分返利及邀请奖励请见[积分与邀请奖励](https://apione.ai/docs/account/rewards.md)。

## 分组定价与计费规则

### 什么是分组定价

APIONE 支持按分组设置模型价格。同一个模型在不同分组中可以采用不同的价格，满足个人开发者、企业客户及不同业务场景的需求。发起请求时，系统会根据该 API Key 选择的分组，自动应用对应的模型价格。

### 分组如何影响价格

| 分组类型 | 适用场景与计费方式 |
| - | - |
| 默认分组 | 适用于常规模型调用，按标准价格计费。 |
| 优惠分组 | 面向符合条件的用户，为特定模型提供优惠价格。 |
| 专属分组 | 面向企业或合作客户，可配置专属模型价格。 |

具体分组名称、可用模型及价格，以平台实际展示为准。一个分组不一定支持平台上的全部模型。

### Token 费用如何计算

对于按 Token 计费的模型，当输入、输出单价均以“每百万 Token”为单位时，可按以下公式计算基础费用：

```text theme={null}
输入费用 = 输入 Token 数量 ÷ 1,000,000 × 输入单价
输出费用 = 输出 Token 数量 ÷ 1,000,000 × 输出单价
```

基础 Token 费用为输入费用与输出费用之和。这里的单价应使用该 API Key 所选分组中对应模型的价格。缓存 Token、特殊计费项目及模型自身的定价规则可能影响最终费用，请按相应规则核算。

### 计算示例

假设一次请求使用 10,000 个输入 Token 和 2,000 个输出 Token，输入、输出单价分别为每百万 Token 的 P 和 Q，则基础费用为 `0.01 × P + 0.002 × Q`。这是公式演示，P、Q 需替换为所选模型和分组的实际单价。

### 如何选择分组

1. 进入 [APIONE 控制台](https://apione.ai/zh/app/api-keys)，打开 API Key 管理页面。
2. 创建或编辑 API Key，选择当前可用的计费分组。
3. 核对该分组支持的模型，以及对应的输入、输出价格。
4. 保存配置后，使用该 API Key 发起模型请求。

> [!NOTE]
>
> 相同模型在不同分组下的价格可能不同。分组价格可能调整，请以平台最新展示为准；实际费用以平台用量记录及账单为准。

## 套餐额度与充值余额

APIONE 套餐为一次性购买，**不自动续费**。购买后一次性发放全部额度，不按天发放，有效期统一为 **28 天**。

| 套餐 | 购买价格 | 一次性到账额度 | 有效期 |
| - | - | - | - |
| Plus | \$20 | \$23 | 28 天 |
| Pro | \$99 | \$120 | 28 天 |
| Max | \$240 | \$300 | 28 天 |

按量计费余额独立于套餐，不受套餐升级和到期影响。套餐到期后自动失效，未使用的套餐额度清零；如需继续使用套餐，自行选择并重新购买。

### 有效期内升级

有效期内允许随时升级，按剩余时间比例补齐新旧套餐价格差额，立即生效。升级继承原套餐剩余有效期，不重新获得 28 天。例如，Plus 已使用 20 天，升级 Pro 后只剩 8 天。

保留旧套餐剩余额度，再按剩余时间比例增加新旧套餐的总额度差额，不重新发放一份完整的新套餐额度。多次升级均以升级前的当前套餐档位计算价差和额度差，避免重复领取。

```text theme={null}
升级费用 =（新套餐价格 − 旧套餐价格）× 剩余时间 ÷ 28 天
新增额度 =（新套餐总额度 − 旧套餐总额度）× 剩余时间 ÷ 28 天
升级后可用额度 = 旧套餐剩余额度 + 新增额度
```

例如，Plus 已使用 20 天，剩余 8 天且剩余额度为 \$3，此时升级 Pro：

| 项目 | 计算结果 |
| - | - |
| 升级费用 | (\$99 − \$20) × 8 ÷ 28 ≈ \$22.57 |
| 新增额度 | (\$120 − \$23) × 8 ÷ 28 ≈ \$27.71 |
| 升级后可用额度 | \$3 + \$27.71 ≈ \$30.71 |
| 剩余有效期 | 8 天，沿用原到期时间 |

示例按整天计算并显示到美分。实际结算按剩余时间比例计算，精度以升级确认页为准。

### 降级与到期

不支持降级；需等当前套餐到期后，自行选择并购买其他套餐。到期时仅清零未使用的套餐额度，不影响独立的按量计费余额，不会自动续费。

### 充值后如何核对

1. 在充值页选择金额，进入收银台，核对实际支付币种、金额及支付方式。
2. 支付完成后返回 APIONE，检查订单状态和余额变化。
3. 若订单仍在处理中，先查询原订单并保留支付凭证。
4. 需要支持时，提供订单号、支付时间和金额，避免提交完整支付账号或 API Key。

积分兑换与邀请奖励按[奖励规则](https://apione.ai/docs/account/rewards.md)执行。积分有效期与套餐有效期分别计算。

## 控制并发

APIONE 按 API Key 控制同时执行的请求数，也可能遇到上游限流。并发配额以账户配置为准。批量任务应使用队列或信号量限制同时进行的请求。

429 响应包含 `Retry-After` 时先遵守该值，再做有上限的指数退避与随机抖动；不要无限重试，也不要通过创建更多 Key 绕过服务限制。流式中断后不要静默重发，避免重复生成与费用。

## 失败、取消与中断如何计费

平台最终判定失败的模型调用不收费。客户端显示超时、主动取消、连接中断，或生成成功后下载失败，不等于平台调用失败；若平台已完成生成或确认了实际用量，相应费用按该模型和分组的规则结算。

流式请求应结合最终状态与实际用量判断，不能只看 HTTP 200、客户端错误提示或是否收到了全部输出。已生成的内容未被完整接收，也不代表没有发生调用。

状态或扣费有疑问时，保留请求 ID、发生时间和时区、模型、最终状态及错误信息，联系支持核查。核实误扣或重复扣费后更正账目；不要在状态未知时连续重新创建任务。

| 情况 | 判断与计费口径 |
| - | - |
| 鉴权、参数或限流检查未通过，请求未进入模型执行 | 不产生该次模型调用费用 |
| 平台最终确认模型调用失败 | 失败的模型调用不收费 |
| 客户端取消、超时或收到部分流式输出后断线 | 不直接视为平台失败；核对最终状态及已确认的实际用量 |
| 图片或视频已生成成功，但下载失败 | 生成与下载分开判断；下载失败不会自动撤销已完成生成的费用 |
| 视频任务已创建，最终状态尚不明确 | 查询原任务并保留任务 ID，不因客户端等待超时而反复创建 |

## 成本检查单

* 控制历史长度与最大输出，避免无意义的长上下文。
* 先用小规模业务样例比较质量与实际消耗。
* 将测试与生产密钥分开，及时调查异常用量。
* 客户端报错时先核对平台最终状态，状态未知时避免立即重复请求。

依据：[用量说明](https://apione.ai/zh/api-docs/docs/usage)、[限流说明](https://apione.ai/zh/api-docs/docs/rate-limits)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.