STATE & BILLING
状态与计费
任务只有 5 种对外状态。「失败」要分三种情况看:有的不收费,有的照样收费但可以申诉。
计费规则一句话
预审不通过、执行失败、排队取消不收钱;成片审核不通过照样收钱、不给视频(支持 7 天内申诉)。
5 种状态与可执行的操作
| 状态 | status | 查询 | 取消 | 下载成片 | 刷新下载链接 | 申诉 |
|---|---|---|---|---|---|---|
| 排队中 | QUEUED | 可以 | 可以 | 不可以 | 不可以 | 不可以 |
| 跑任务中 | RUNNING | 可以 | 不可以 | 不可以 | 不可以 | 不可以 |
| 成功 | SUCCEEDED | 可以 | 不可以 | 可以 | 可以 | 不可以 |
| 失败 | FAILED | 可以 | 不可以 | 不可以 | 不可以 | 仅成片审核不通过,7 天内 |
| 已取消 | CANCELED | 可以 | 不可以 | 不可以 | 不可以 | 不可以 |
- 排队中下单成功、已冻结预计金额,正在排队等待生成。可以取消,取消后全额退回。
- 跑任务中正在生成或等待成片审核,已不能取消。
- 成功成片审核通过,按实际成片时长扣费,提供下载链接。(接口 status_zh 为「生成成功」)
- 失败分三种情况,收不收费不一样,见下方「失败的三种情况」。(接口 status_zh 为「生成失败」)
- 已取消排队阶段被取消,没有开始生成,冻结金额全额退回。
失败的三种情况
状态为 FAILED 时,用 audit_status 与 billing_status 判断属于哪一种:
预审不通过
不收费不可申诉提示词或输入素材违规,或涉及真人肖像 / 声音却没有覆盖相应范围的有效本人授权。任务在开始生成之前就被拦下,冻结金额全额退回。
接口字段:
audit_status = PRE_AUDIT_REJECTED,billing_status = UNFROZEN修改提示词或素材、补充本人授权后,换一个新的 external_id 重新下单(原单号永久对应这条失败的任务:内容相同会直接返回它,内容不同返回 409 EXTERNAL_ID_CONFLICT)。
成片审核不通过
照样收费7 天内可申诉视频已经生成,但成片没有通过内容审核:按成片时长照常扣费,不提供视频。
接口字段:
audit_status 为 POST_AUDIT_REJECTED(申诉裁决后为 APPEAL_UPHELD 或 APPEAL_REFUNDED),billing_status 为 CHARGED(申诉退款后为 REFUNDED_BY_APPEAL);can_appeal 只在 7 天内且尚未申诉时为 true如认为判定有误,在 appeal_deadline_at 之前提交申诉,人工复核。
系统失败或排队超时
不收费无需申诉生成过程出错,或排队超过最长等待时间(默认 24 小时)。没有产出成片,冻结金额全额退回。
接口字段:
billing_status = UNFROZEN,且 audit_status 不是 PRE_AUDIT_REJECTED任务已经失败(结果确定)时,换一个新的 external_id 重新提交(原单号永久对应这条失败的任务);如持续出现,带上 request_id 联系我们。如果创建请求收到的是 500 OUTCOME_UNKNOWN(结果不确定),不要换单号:用同一个 external_id 重发,重发是安全的。
计费结果矩阵
| 结果 | 是否收费 | 给不给视频 | 申诉 | 说明 |
|---|---|---|---|---|
| 预审不通过 | 不收费 | 不提供 | 不适用 | 提示词或输入素材违规,或缺少有效的真人本人授权,开始生成前即被拦截。 |
| 执行失败 | 不收费 | 不提供 | 不适用 | 生成过程出错或排队超时,没有产出成片。 |
| 排队取消 | 不收费 | 不提供 | 不适用 | 排队阶段主动取消,任务没有开始生成。 |
| 成片审核通过 | 收费 | 提供下载 | 不适用 | 成片通过审核,按实际成片时长扣费。 |
| 成片审核不通过 | 收费 | 不提供 | 7 天内可申诉 | 视频已生成但成片审核不通过:照样扣费、不给视频。 |
预冻结与结算
- 下单时按请求时长向上取整到整秒冻结:
ceil(frames / fps) × 单价,单条最多冻结 16 秒。 余额不足返回402 INSUFFICIENT_BALANCE,不会创建任务。 - 成片审核结束后(通过或不通过),按成片时长结算:
成片整数秒 × 单价。成片时长是生成回调给出的整数秒, 成功任务里就是output.duration_sec。 - 多冻结的部分退回可用余额;不收费的情况全额退回。
例:362 帧、1376×768、有声
- 下单冻结
- 16 × ¥0.28 = ¥4.48
- 若成片 15 秒,实扣
- 15 × ¥0.28 = ¥4.20
- 退回可用余额
- ¥0.28
下载链接与留存
- 成功任务的
output.video_url自签发起 24 小时有效,到期时间见output.video_url_expires_at。 - 过期后在 30 天内再次查询该任务,会自动换发新的 24 小时链接,不额外收费; 直接访问过期链接会得到
410 DOWNLOAD_URL_EXPIRED。 - 任务只能在 30 天内查询(成片链接也只能在这段时间里刷新),超过 30 天的查询期再查返回
404 TASK_RETENTION_EXPIRED。
申诉
成片审核不通过的任务,在 appeal_deadline_at(审核结束后 7 天)之前、且还没有申诉过时,can_appeal 为 true,可以提交申诉,由人工复核;已申诉或过了 7 天即为 false。裁决后会再次发送 Webhook 通知,appeal_ruling_verdict 为以下三种之一:
| 裁决 | 任务状态 / audit_status | 费用 / billing_status | 视频 |
|---|---|---|---|
| MISJUDGED_PASS | 成功APPEAL_APPROVED | 维持扣费(CHARGED) | 改判通过,提供下载 |
| MODEL_GLITCH_REFUND | 失败APPEAL_REFUNDED | 全额退款(REFUNDED_BY_APPEAL) | 不提供 |
| UPHOLD_REJECTION | 失败APPEAL_UPHELD | 维持扣费(CHARGED) | 维持不通过,不提供 |