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

# 计费说明

> 每次请求的费用怎么算、倍率是什么，以及请求在什么情况下会因为额度被拒绝。

TokenHub 按量计费：没有月费，每次请求结束后按实际用量从余额里扣。余额以美元计价，充值时用人民币支付。

## 一次请求的费用

```text theme={null}
费用 = 基础成本 × 倍率

基础成本 = 输入 token    × 输入单价
         + 输出 token    × 输出单价
         + 缓存读取 token × 缓存读取单价
         + 缓存写入 token × 缓存写入单价（5 分钟 / 1 小时两档）
         + 联网搜索次数  × 每次单价
```

* **单价**按模型设定。部分模型按上下文长度分档定价：根据这次请求的完整输入长度（含缓存）选中一档，输入和输出都按这一档的价格计算。
* **倍率**由分组决定，见下文。
* **失败的请求不收费。**

在 **控制台 → 用量统计** 里，把鼠标移到某条请求的「总成本」上，就能看到这条请求按上面公式拆开的每一项。「计费依据」一列显示用的是固定价，还是落在了哪一档。

> [!TIP]
>
> 提示词缓存能明显降低费用：缓存读取的单价远低于普通输入。Claude Code 会自动使用缓存，在概览里可以看到缓存命中率。

## 倍率

每个分组都有一个计费倍率，在创建密钥、选择分组时就能看到：

* `1.50x` 这样的单个数字：这个分组的所有请求都按这个倍率计费。
* `1.00x~2.00x` 这样的范围：倍率取决于请求实际走的哪条线路，每次请求的实际倍率可以在费用构成里看到。
* 倍率正好是 `1.00x` 时不显示标签。

## 预留与结算

每个请求开始时，TokenHub 会先从可用余额里预留一笔额度（目前每个请求 1 美元），请求结束后按实际费用扣费，并释放这笔预留。

这意味着：

* 可用余额不足 1 美元时，新请求会被拒绝（`402`）。
* 同时进行的请求越多，预留占用的额度越多。比如同时跑 5 个请求，就需要至少 5 美元可用余额。
* 预留只是暂扣，不是实际费用。余额页的「预留金额」就是正在进行的请求占用的部分。

结算时按实际费用全额扣除，即使超过了预留金额。所以余额可能变成负数，这时所有请求都会被拒绝，充值补足欠款后自动恢复。见 [余额不足与欠费](https://docs.aitokenhub.vip/console/billing.md)。

## 各种上限

一个请求要同时满足下面所有设置了的上限：

| 上限 | 谁来设 | 超出后 |
| - | - | - |
| 密钥支出上限 | 密钥的创建者或团队管理员，在 [API 密钥](https://docs.aitokenhub.vip/console/api-keys.md) 里设置 | 这把密钥的请求被拒绝（402） |
| 设备支出上限 | 在设备页设置 | 这台设备的请求被拒绝（402） |
| 成员额度 | 团队管理员，见 [团队与成员](https://docs.aitokenhub.vip/console/teams.md) | 该成员所有密钥和设备的请求被拒绝（402） |
| 并发上限 | 平台按个人 / 团队设定 | 超出的请求被拒绝（429），稍后重试即可 |

密钥、设备和成员的「累计用量」都可以手动重置，重置后上限从头计算。「本月消费」按自然月（北京时间）统计，不能重置。


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