跳到正文
通达云视频

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 天内可申诉视频已生成但成片审核不通过:照样扣费、不给视频。

预冻结与结算

  1. 下单时按请求时长向上取整到整秒冻结:ceil(frames / fps) × 单价,单条最多冻结 16 秒。 余额不足返回 402 INSUFFICIENT_BALANCE,不会创建任务。
  2. 成片审核结束后(通过或不通过),按成片时长结算:成片整数秒 × 单价。成片时长是生成回调给出的整数秒, 成功任务里就是 output.duration_sec。
  3. 多冻结的部分退回可用余额;不收费的情况全额退回。

例: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)维持不通过,不提供