查询任务与结果

轮询任务状态、拿到视频链接、以及链接有效期的重要提醒。

最后更新：2026-10-13

用提交时拿到的任务 id 查询状态：

curl https://yqzktech.com/v1/videos/video_01a2b3c4d5e6 \
  -H "Authorization: Bearer $API_KEY"

{
  "id": "video_01a2b3c4d5e6",
  "object": "video",
  "status": "completed",
  "progress": 100,
  "created_at": 1760000000,
  "completed_at": 1760000198,
  "metadata": {
    "url": "https://.../video.mp4?X-Tos-Expires=86400"
  }
}

任务状态流转：

状态	含义	建议动作
`queued`	已进入队列，等待执行	继续轮询，间隔建议 ≥ 10 秒
`in_progress`	正在生成，progress 递增	可展示进度条，间隔 ≥ 5 秒
`completed`	生成完成，metadata.url 可下载	尽快转存视频
`failed`	生成失败	不计费，可重试或提交工单

重要：结果视频链接的有效期只有 24 小时（上游签名链接）。拿到 url 后请尽快转存到你自己的对象存储，不要直接把该链接当成长期资源引用。

说明：轮询不要过于频繁。生成一条视频通常要 1–5 minutes，秒级轮询只会徒增失败请求数。