> 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.

# 智能体计价与充值

## 扣费时点

受理时按预估扣费、完成时按实际校正;失败与无产物不计费。两种拒绝都发生在**扣费之前**:

| HTTP | 错误码    | 场景         | 处理           |
| ---- | ------ | ---------- | ------------ |
| 402  | `1005` | 账户余额不足     | 充值;已在途任务不受影响 |
| 402  | `1013` | 单 Key 限额触顶 | 提高限额或换 Key   |

## 充值与监控

充值与方案由平台运营侧管理(分销下级由上级分销商充值,见[分销体系](https://docs.reelway.ai/pricing/reseller.md));账户余额与流水见[余额与用量](https://docs.reelway.ai/api-reference/account-and-usage.md)。

生产智能体建议:

- 监控 `GET /v4/account/balance` 并设阈值告警;
- 所有付费 `POST` 带 `Idempotency-Key`(workflows / chat runs / world builds);
- 每日用量对账用 `GET /v1/transactions/list`。

## 单价

按「模型 × 分辨率桶」的价格规则计价;缺少价格行时提交被拒(`400`/`1014`),不会静默免费。单价以运营配置为准。