Wan 任务查询

万相 3.0 任务提交后，通过查询入口按任务 ID 轮询状态与结果。

GET /v1/videos/{task_id}

建议每 10–15 秒查询一次，不要为查询进度重复创建任务。任务完成后从 读取视频地址。

请求头

名称	类型	必填	说明
	string	是	请求身份认证。使用 Bearer Token，示例：

请求参数

名称	类型	必填	说明
	string	是	路径参数，与生成接口返回的 id 或 task_id 一致

请求示例

curl https://octopusx.ai/v1/videos/task_1234567890abcdef \
  -H "Authorization: Bearer <token>"

状态枚举

状态	说明
	任务排队中
	任务生成中
	任务成功完成
	任务失败、取消或上游任务不存在
	当前状态无法识别

响应示例

排队中

{
  "id": "task_1234567890abcdef",
  "object": "video",
  "model": "wan3.0-video-prime",
  "status": "queued",
  "progress": 0,
  "created_at": 1787673600,
  "completed_at": 1787673601,
  "metadata": {
    "url": ""
  }
}

生成中

{
  "id": "task_1234567890abcdef",
  "object": "video",
  "model": "wan3.0-video-prime",
  "status": "in_progress",
  "progress": 50,
  "created_at": 1787673600,
  "completed_at": 1787673610,
  "metadata": {
    "url": ""
  }
}

已完成

{
  "id": "task_1234567890abcdef",
  "object": "video",
  "model": "wan3.0-video-prime",
  "status": "completed",
  "progress": 100,
  "created_at": 1787673600,
  "completed_at": 1787673610,
  "metadata": {
    "url": "https://example.com/output.mp4"
  }
}

响应字段

名称	类型	说明
	string	任务 ID
	string	固定为
	string	状态枚举见上
	integer	进度百分比
	integer	创建时间戳
	integer	状态更新时间戳
	string	完成后的结果视频地址

相关接口

• 视频系列概览
• Wan 视频生成
• 错误码查询