# 计费说明

## 计费规则

- 按实际使用的 token 数量计费，输入和输出分别计价
- 价格单位：CNY / 千 tokens
- 流式和非流式请求均支持精确计费
- 请求失败（超时、上游错误）不扣费

## 冻结-结算机制

每次请求的计费流程：

1. **预冻结** -- 请求开始时，根据输入 token 数估算费用并冻结余额
2. **实际结算** -- 请求完成后，按实际用量（输入 + 输出 token）计算费用
3. **退还差额** -- 多冻结的部分自动退还到账户余额

## 媒体生成计费

| 类型 | 计费方式 |
| --- | --- |
| 图片生成 | 按张计费，价格因模型和尺寸而异 |
| 文本转语音 | 按字符数计费 |
| 语音转文本 | 按音频时长计费 |
| 语音妙记 | 接口 `POST /v1/audio/minutes`（仅中国站）。`xrtoken-minutes`：识别按时长、总结按 token。`doubao-minutes`：按时长（转写 + 附加能力，或 `all_activate` 打包）。具体价格见[模型市场](/dashboard/models) |
| 视频生成 | 按视频时长计费 |

各模型具体价格请查看[模型市场](/dashboard/models)。

## 联网搜索计费

| 类型 | 计费方式 |
| --- | --- |
| 联网搜索 / 全球搜索 | **按次**计费（与返回条数无关）；价格见模型市场 |

接口：`POST /v1/search`，用 body `Type=web|global` 选择。失败不扣费。详见 [联网搜索](/docs/web-search)。

## 余额查询接口

```http
GET /v1/credits/balance
Authorization: Bearer tr-xxxxxxxx
```

返回：

```json
{
  "balance": 12.50,
  "frozen": 0.50,
  "available": 12.00,
  "currency": "CNY"
}
```

字段含义：

| 字段 | 含义 |
| --- | --- |
| `balance` | 账户总余额（含正在进行中的请求冻结部分） |
| `frozen` | 当前进行中的请求冻结金额 |
| `available` | 可用余额 = `balance - frozen` |
| `currency` | `CNY`（中国版）或 `USD`（国际版） |

国际版 (xrtoken.ai) 单位是 USD；中国版 (xrtoken.net) 单位是 CNY。