Skip to main content
GET

Wan 3.0 查询视频任务

Wan 3.0 视频任务是异步执行的。创建任务后,保存响应中的 idtask_id,再通过 GET /v1/videos/{task_id} 轮询任务状态。任务完成后,可以读取 video_url,或者使用内容代理接口下载 MP4。

查询任务

下载视频内容

下载接口建议继续携带鉴权头。任务完成后,如果查询响应没有直接返回可访问的 video_url,可以使用此接口获取视频内容。

响应示例

Path Parameters

string
required
创建接口返回的任务 ID。通常使用响应中的 id,部分响应也会返回兼容字段 task_id

状态处理

如果响应使用百炼原始结构,则:
  • output.task_status = SUCCEEDED 表示生成成功。
  • output.task_status 处于排队或运行状态时,继续轮询。
  • 其他失败状态应按失败任务处理,并记录完整的 output 或错误信息。
建议轮询间隔保持在 510 秒。任务处理中不要重复提交相同的生成请求。

Response

string
视频任务 ID。后续用于查询状态或下载视频内容。
string
视频任务 ID 的兼容字段,通常与 id 相同。
string
对象类型,通常为 video
string
任务实际使用的模型,例如 wan3.0-videowan3.0-video-prime
string
统一任务状态,常见值为 queuedin_progresscompletedfailed
integer
任务进度百分比。部分上游不会稳定更新进度,客户端应以终态状态为准。
string
生成完成后的视频地址。为空或不可访问时,可使用 /v1/videos/{task_id}/content 下载。
object
任务附加信息,可能包含 content_url、过期时间或计费用量等字段。
object
任务失败时返回的错误对象,通常包含 codemessage

常见问题

相关接口