Wan 视频生成 - 查询视频任务

Wan 视频生成 · 查询任务

按平台 task_id 查询 Wan 视频任务状态、视频 URL 和计费快照。本接口只读取平台任务表中的数据。

<details>
<summary>基本信息</summary>

字段内容
类型应用 API
应用编码wan
API 编码query
请求方式GET
请求路径/api/v1/apps/wan/query
调用模式同步

</details>

鉴权

Authorization: Bearer <YOUR_API_KEY>

请求路径

GET /api/v1/apps/wan/query?task_id={task_id}

业务参数

参数类型必填示例说明
task_idstring是task_xxxxxxxxxxxx创建接口返回的平台任务 ID

请求示例

GET /api/v1/apps/wan/query?task_id=task_xxxxxxxxxxxx

处理中响应

{
  "code": 1,
  "msg": "success",
  "data": {
    "status": "processing"
  }
}

完成响应

{
  "code": 1,
  "msg": "success",
  "data": {
    "status": "completed",
    "task_id": "task_xxxxxxxxxxxx",
    "model": "wan2.7",
    "resolution": "720p",
    "duration": 5,
    "video_url": "https://example.com/output.mp4",
    "data": {
      "video_url": "https://example.com/output.mp4"
    },
    "frozen_points": 717.1,
    "actual_points": 717.1
  }
}

字段说明:

字段说明
statusprocessing 表示处理中,completed 表示成功完成
video_url生成视频地址,优先使用该字段播放或下载
data.video_url与 video_url 等价,便于兼容不同客户端解析
frozen_points创建任务时冻结的点数
actual_points任务完成后实际扣除点数

建议客户端每 3 到 5 秒轮询一次;收到 completed 后停止轮询。若创建任务时传入 callback_url,也可以以回调为主、轮询为辅。

失败响应

{
  "error": {
    "message": "任务不存在或不属于当前租户",
    "code": "task_not_found"
  }
}

常见错误码

HTTPcode含义
400missing_task_id未传任务 ID
401auth_failedAPI Key 缺失或无效
404task_not_found任务不存在或不属于当前租户
5xxserver_error / task_error平台服务异常或任务处理失败

同类文章