查询视频
查询 Wan 3.0 平台视频对象的进度与结果。
使用创建接口返回的公开任务 ID 查询，响应为单个 video 对象。
GET
/v1/videos/{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
读取状态与视频地址
status | 含义与处理 |
|---|---|
queued | 排队中，稍后继续查询 |
in_progress | 处理中，稍后继续查询 |
completed | 生成完成，从 metadata.url 获取视频地址 |
failed | 生成失败，读取可用的 error 信息并停止轮询 |
unknown | 未识别的任务状态，不作为生成成功处理 |
保存响应的 id；查询对象不依赖创建响应中的冗余 task_id。不能仅根据 progress、completed_at 或 error 是否存在判断成功；completed_at 来自平台记录的更新时间，状态以 status 为准。
成功后可直接保存视频地址，或使用下载视频接口。本接口不返回原生 output/usage 对象；需要用量字段时参阅原生查询。
轮询与错误处理
建议约每 15 秒查询一次，并设置总等待超时。查询读取平台任务记录，短时间重复查询可能得到相同状态；停止轮询不会取消生成任务。
收到 HTTP 400 和 task_not_exist 时，请确认任务 ID 来自对应站点，并使用该任务所属账户的 API Key。收到 HTTP 401 时，请先检查鉴权，再继续查询。视频是否生成成功以 status 为准。