AGTCloud API Docs
文档指南API Reference集成与资源更新与帮助
视频生成Wan

查询任务 · 旧版格式

通过旧版响应格式查询 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。

Length1 <= length

Response 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,再处理返回的任务数据。

阿里云万相 3.0 视频生成官方文档查阅模型原生协议;本页平台字段与响应以页面说明为准。