跳转到正文MaoMaoToken
控制台

任务状态与进度

任务状态流转

状态含义客户端动作
queued已收到请求,等待执行队列处理保存任务 ID,稍后继续查询
in_progress已开始生成处理中按推荐间隔继续查询
completed生成成功,视频可下载从 video_url 下载并保存视频
failed任务未能完成读取 error 字段,根据错误类型处理

进度字段

响应中的 progress 字段为 0–100 的整数,用于表示任务的处理进度。

进度可能随处理阶段更新,并在同一阶段内保持不变。不应根据进度值估算剩余时间,任务是否完成以 status 为准。

状态转移示例

创建请求
    ↓
status: queued (progress: 0)
    ↓ [等待]
status: in_progress (progress: 30-80)
    ↓ [等待]
status: completed (progress: 100)
    → 使用 video_url 下载

或

status: in_progress (progress: 50)
    ↓ [等待]
status: failed
    → 读取 error,处理失败原因

重要提示

  • 创建响应中的 queued 仅表示任务已受理
  • 不能将任务收到视为视频已生成,应等待 completed 状态
  • 长时间处于 in_progress 是正常现象,不代表任务卡顿
本页内容

On this page