查询任务 · 旧版格式
通过旧版响应格式查询 Wan 3.0 视频任务。
此路径返回 code/message/data 包装的旧版任务对象。新接入优先使用平台查询接口;两者的响应结构不能互换。
GET
/v1/video/generations/{task_id}Authorization
bearerAuth AuthorizationBearer <token>
使用平台 API Key:Authorization: Bearer your-api-key。
In: header
Path Parameters
task_id*string
平台返回的公开任务 ID,按字符串保存。查询与下载均使用此值,不使用 request_id 或内层上游任务 ID。
Length
1 <= lengthResponse Body
application/json
application/json
application/json
如何读取旧版结果
code: "success" 只表示查询成功,仍需检查 data.status:
| 状态 | 含义 |
|---|---|
NOT_START/SUBMITTED/QUEUED | 尚未执行或已提交、排队中 |
IN_PROGRESS | 处理中 |
SUCCESS | 成功,从 data.result_url 获取视频地址 |
FAILURE | 失败,查看 data.fail_reason 并停止轮询 |
data.progress 是字符串,例如 "100%",不同于平台查询的数值进度。created_at/updated_at/submit_time/start_time/finish_time 使用 Unix 秒时间戳,尚未开始或完成时对应时间可为 0。响应示例展示任务相关字段,实际响应可包含其他字段。
查询和下载均使用创建接口返回的公开任务 ID,即本响应中的 data.task_id。data.data 是原生响应,其中的任务 ID 不用于平台查询或下载。
轮询与错误处理
建议约每 15 秒查询一次,设置总等待超时,在终态停止轮询。生成完成后及时保存视频,停止查询不会取消生成。
HTTP 400 的 task_not_exist 和 HTTP 401 属于查询请求错误,不是正常任务状态;先检查任务 ID、站点和 API Key,再处理返回的任务数据。