请求

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

• 失败时 error 字段包含原因。
• 未完成时轮询间隔建议 ≥ 5 秒。