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

# 计费说明

> 说明充值规则、API 计费方式与最终扣费逻辑。

本文档用于说明平台的充值规则、API 计费方式及最终扣费逻辑。

> 截图占位：计费说明示意图

## 开始前

在阅读计费规则前，建议先明确以下两点：

* 平台采用 `$` 作为站内基础计费单位
* 充值换算规则为 `1 CNY = 1 $`

## 计费规则

### 计费示例

* 倍率 = `2.5`
* 官方 API 费用 = `10 美元`
* 平台扣费 = `25 美元`
* 折合成本 = `25 人民币`

### 1. 基础货币

本平台采用 `$` 作为站内基础计费单位。

#### 充值规则

用户充值时，按照以下比例换算：

```text theme={null}
1 CNY = 1 $
```

例如：

* 充值 `10 CNY`，到账 `10 $`
* 充值 `100 CNY`，到账 `100 $`

### 2. API 计费方式

平台 API 调用费用基于模型官方 API 单价进行计算，并在此基础上乘以分组倍率，得出平台最终扣费金额。

#### 计费项说明

一次 API 调用可能包含以下计费项：

| 计费项    | 说明                |
| ------ | ----------------- |
| 输入单价   | 按请求输入的 token 数量计费 |
| 输出单价   | 按模型输出的 token 数量计费 |
| 缓存创建单价 | 按缓存写入的 token 数量计费 |
| 缓存读取单价 | 按缓存命中的 token 数量计费 |

不同模型支持的计费项可能不同，具体以模型实际计费规则为准。若未使用缓存，则缓存相关费用为 `0`。

### 3. 计费公式

#### 官方 API 费用

```text theme={null}
官方费用 =
(输入 token 数 × 输入单价)
+ (输出 token 数 × 输出单价)
+ (缓存创建 token 数 × 缓存创建单价)
+ (缓存读取 token 数 × 缓存读取单价)
```

#### 平台最终扣费

```text theme={null}
平台扣费 = 官方费用 × 分组倍率
```

也就是说：

1. 先根据模型官方单价和实际 token 消耗计算官方费用
2. 再乘以对应分组倍率
3. 从账户余额中扣除最终金额

### 4. 分组倍率说明

平台可针对不同模型分组或渠道分组设置不同倍率。

| 分组倍率  | 平台扣费含义             | 相当于官方原价的倍率        |
| ----- | ------------------ | ----------------- |
| `1`   | 按官方 USD 费用 1 倍扣费   | 约等于官方原价的 `0.14` 倍 |
| `1.2` | 按官方 USD 费用 1.2 倍扣费 | 约等于官方原价的 `0.17` 倍 |
| `2.5` | 按官方 USD 费用 2.5 倍扣费 | 约等于官方原价的 `0.36` 倍 |

### 5. 扣费规则说明

* 所有 API 调用均按实际消耗的 token 数量计费
* 不同模型的输入、输出、缓存创建、缓存读取单价可能不同
* 不同分组的倍率可能不同
* 若某模型不涉及某项计费，则该项费用按 `0` 计算
* 最终扣费金额以平台实际计算结果为准

### 6. 余额说明

API 请求产生费用后，系统将自动从账户余额中扣除对应的 `$` 金额。

若账户余额不足，可能会出现以下情况：

* 请求被拒绝
* 请求执行失败
* 系统提示余额不足

具体以平台实际策略为准。

## 验证方式

你可以通过以下方式验证自己是否理解当前计费规则：

* 用一次小请求测试实际扣费
* 对照官方模型价格和分组倍率，手动估算扣费结果
* 在控制台核对余额变化是否符合预期

## 常见问题

### 为什么同样的请求，不同模型扣费不同？

因为不同模型的官方 API 单价不同，且不同分组的倍率也可能不同。

### 余额不足时会发生什么？

通常会出现请求被拒绝、执行失败或系统提示余额不足，具体以平台实际策略为准。

## 相关页面

* [加入服务](/getting-started/join-service)
* [Claude Code 接入概览](/claude-code/overview)
* [Codex 接入概览](/codex/overview)
* [常见报错](/help/common-errors)
