计费方式
创建时按上限预留,完成后按实际用量结算,失败和取消的任务不收费。
本页内容
视频生成按用量计费,用量记录在 video_tokens 等计量字段里。每个任务的费用都经过预留、结算两步。
预留
创建任务时,平台按这次请求可能产生的最大用量(quote.)和当前价格版本算出预留金额 quote.reserved_amount,从余额里预留出来。余额不够时返回 429 insufficient_balance,error.details 给出所需的预留金额,任务不会创建。
结算
任务完成后按实际用量(usage.video_tokens)结算:实际费用从预留里扣除,多出的部分释放回余额。settlement_status 变为 settled 后,billing. 就是这个任务的最终费用。
失败和取消不收费
- 失败或取消的任务结算后,最终费用和应收金额都是零,预留全额释放。
- 用 HTTPS 链接的素材准备失败时,任务以
input_*错误失败,预留全额释放,不收生成费。 - 被拒绝的请求(4xx)发生在预留之前,不会预留也不会收费。
一个例子
下面的数字来自本文档的示例任务:
| 步骤 | 用量 | 金额(美元) |
|---|---|---|
| 创建时预留 | 上限 111779 个 video_tokens | 0.782453 |
| 完成后扣费 | 实际 51652 个 video_tokens | 0.361564 |
| 释放差额 | — | 0.420889 |
金额格式
所有金额都是美元,写成六位小数的字符串,例如 "0.361564"。尚未确定的金额为 null。
价格
各模型的标价见「价格」页,本团队适用的价格和版本在控制台查看。文档不写死价格。