查询视频
读取 Wan 3.0 原生任务状态、视频地址和用量。
使用创建响应的 output.task_id 查询，返回的 output.task_id 仍是平台公开任务 ID。结果和用量分别位于 output 与 usage。
/api/v1/tasks/{task_id}Authorization
bearerAuth 使用平台 API Key：Authorization: Bearer your-api-key。
In: header
Path Parameters
平台返回的公开任务 ID，按字符串保存。查询与下载均使用此值，不使用 request_id 或内层上游任务 ID。
1 <= lengthResponse Body
application/json
application/json
application/json
状态与结果
output.task_status | 含义与处理 |
|---|---|
PENDING | 排队中 |
RUNNING | 处理中 |
SUCCEEDED | 成功，从 output.video_url 读取结果 |
FAILED | 失败，读取 output.code/message 并停止轮询 |
CANCELED | 已取消，停止轮询 |
UNKNOWN | 任务状态未知，不作为成功处理 |
建议约每 15 秒查询一次，并设置总等待超时。查询读取平台保存的任务记录，状态由后台更新；不要使用重复创建代替查询。
视频生成成功后请及时下载保存，避免结果地址失效。
用量与时间字段
usage.duration 为总用量时长；有输入视频时，包含输入与输出视频时长。input_video_duration/output_video_duration 可含小数，不应按请求时长的整数规则解析。其他可返回字段包括 video_count、fps、SR 和 ratio。
submit_time/scheduled_time/end_time 是 UTC+8 时间字符串，存在时返回，不是 Unix 时间戳。request_id 用于追踪请求，不用于查询任务。
查询错误
收到 HTTP 400 和 task_not_exist 时，请检查公开任务 ID、调用站点和 API Key 所属账户；这与任务的 UNKNOWN 状态不同。收到 HTTP 401 时，请检查 Bearer 鉴权。
错误响应可能仅包含顶层 code/message/request_id，不包含 output。如需使用 video 对象格式，参阅平台查询接口。