请求

GET /api/v1/task/{task_id}

Headers: X-API-Key: h3k_...

响应

{
  "id": "uuid",
  "status": "completed",
  "progress": { "stage": "sample", "step": 12, "total_steps": 20 },
  "result_url": "videos/xxx.mp4",
  "error": null,
  "created_at": "2026-08-20T00:00:00Z"
}

状态机

queued → running → completed | failed

• queued：排队中，还没轮到。
• running：已经在 GPU 上跑了，progress 里能看到当前进度。
• completed：生成完成，result_url 可以拿去下载。
• failed：失败了，error 里是原因。

轮询间隔建议至少 5 秒。生成一条视频通常要几分钟，太频繁地刷没有意义，反而容易撞限流。