API v1

计费方式

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

查看 Markdown
本页内容

视频生成按用量计费,用量记录在 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_tokens0.782453
完成后扣费实际 51652 个 video_tokens0.361564
释放差额—0.420889

金额格式

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

价格

各模型的标价见「价格」页,本团队适用的价格和版本在控制台查看。文档不写死价格。

下一步