> For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt.

# 计费与成本控制

## 钱从哪里扣

统一从**账户余额**扣费。查询 `GET /v4/account/balance`,流水 `GET /v1/transactions/list`。不存在代币双轨或订阅抵扣。

## 扣费时点

```
提交 ──受理(按预估扣费)──► 执行 ──完成(按实际校正)──► 差额回补
```

失败或无产物的任务不计费;已在途任务不受余额波动影响。

## 成本控制手段

| 手段       | 机制                                                                                                  |
| -------- | --------------------------------------------------------------------------------------------------- |
| 单 Key 限额 | 为每把 API Key 设置配额,触顶 `402`(`1013`);隔离失控重试的爆炸半径                                                       |
| 幂等键      | 三个付费 `POST`(workflows / chat runs / world builds)携带 `Idempotency-Key`,网络重试不会重复扣费(同键异体 `422`/`1012`) |
| 目录刷新     | 模型不在目录 `400`(`1002`)、缺价格行 `400`(`1014`)在**扣费前**拒绝                                                   |
| 预估       | socket estimate 端点返回结构完整的零报价(`preview`),实际扣费以受理时价格规则为准                                              |
| 余额告警     | 监控 `GET /v4/account/balance` 并设阈值;余额不足时提交在扣费前被拒(`402`/`1005`)                                       |

## 对账

- 流水 `GET /v1/transactions/list` 分页(`limit`/`offset`,`next` 游标);按 Key 拆分的用量在控制台 Key 列表。
- [回放记录](https://docs.reelway.ai/api-reference/replay.md)可把每次任务的参数与种子归档,支撑事后复现与审计。

## 分销场景

下级账户的余额由分销商充值,费率沿链连乘;分销商毛利报表见[分销体系](https://docs.reelway.ai/pricing/reseller.md)。