# 计费方式

创建时按上限预留，完成后按实际用量结算，失败和取消的任务不收费。

视频生成按用量计费，用量记录在 `video_tokens` 等计量字段里。每个任务的费用都经过预留、结算两步。

## 预留

创建任务时，平台按这次请求可能产生的最大用量（`quote.estimated_usage_upper_bound.video_tokens`）和当前价格版本算出预留金额 `quote.reserved_amount`，从余额里预留出来。余额不够时返回 `429 insufficient_balance`，`error.details` 给出所需的预留金额，任务不会创建。

## 结算

任务完成后按实际用量（`usage.video_tokens`）结算：实际费用从预留里扣除，多出的部分释放回余额。`settlement_status` 变为 `settled` 后，`billing.final_actual_cost` 就是这个任务的最终费用。

## 失败和取消不收费

- 失败或取消的任务结算后，最终费用和应收金额都是零，预留全额释放。
- 用 HTTPS 链接的素材准备失败时，任务以 `input_*` 错误失败，预留全额释放，不收生成费。
- 被拒绝的请求（4xx）发生在预留之前，不会预留也不会收费。

## 一个例子

下面的数字来自本文档的示例任务：

| 步骤 | 用量 | 金额（美元） |
| --- | --- | --- |
| 创建时预留 | 上限 111779 个 `video_tokens` | `0.782453` |
| 完成后扣费 | 实际 51652 个 `video_tokens` | `0.361564` |
| 释放差额 | — | `0.420889` |

## 金额格式

所有金额都是美元，写成六位小数的字符串，例如 `"0.361564"`。尚未确定的金额为 `null`。

## 价格

各模型的标价见「[价格](./public-prices.html)」页，本团队适用的价格和版本在控制台查看。文档不写死价格。

## 下一步

- [对账](./api-docs-zh-billing-reconcile.md)：用任务账单接口核对每个任务的预留、扣款、退款和应收。
- [查询单任务账单](./api-docs-zh-api-video-tasks-billing.md)：读取本团队任务的稳定账单汇总及一页有序、不可变的账单事件。