查询任务

文档版本：v1.0.0 | 最后更新：2026-07-22
本平台已完整适配通义万相（Wan）官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

通过 task_id 轮询任意万相异步任务（文生视频、图生视频、参考生视频、视频编辑、首尾帧、动作迁移、数字人、VACE）的状态及结果。

接口定义

GET https://platform.shuyanai.com/ali/api/v1/tasks/{task_id}

路径参数

参数	类型	必填	说明
`task_id`	string	是	创建任务时返回的 `output.task_id`，有效期 24 小时

请求头

参数	类型	必填	说明
`Authorization`	string	是	`Bearer {API_KEY}`

请求示例

curl --request GET \
  --url 'https://platform.shuyanai.com/ali/api/v1/tasks/{task_id}' \
  --header 'Authorization: Bearer <token>'

响应说明

处理中（PENDING / RUNNING）

{
  "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "RUNNING",
    "submit_time": "2026-07-22 11:31:35.916",
    "scheduled_time": "2026-07-22 11:31:35.973"
  }
}

成功（SUCCEEDED）

{
  "request_id": "caa62a12-0972-9762-96c7-8cd0cd10bc9f",
  "output": {
    "task_id": "eff1443c-b8b0-42b4-a973-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-07-22 11:31:35.916",
    "scheduled_time": "2026-07-22 11:31:35.973",
    "end_time": "2026-07-22 11:35:14.377",
    "orig_prompt": "一只猫在草地上奔跑",
    "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx"
  },
  "usage": {
    "duration": 5,
    "input_video_duration": 0,
    "output_video_duration": 5,
    "video_count": 1,
    "SR": 1080
  }
}

失败（FAILED）

{
  "request_id": "xxxx",
  "output": {
    "task_id": "xxxx",
    "task_status": "FAILED",
    "code": "InvalidParameter",
    "message": "The size is not match xxxxxx"
  }
}

任务不存在

{
  "code": "task_not_exist",
  "message": "task_not_exist",
  "data": null
}

响应字段

output

字段	类型	说明
`task_id`	string	任务 ID
`task_status`	string	任务状态：`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN`
`submit_time` / `scheduled_time` / `end_time`	string	任务提交 / 开始执行 / 完成时间，格式 `YYYY-MM-DD HH:mm:ss.SSS`
`video_url`	string	生成的视频地址，仅 `SUCCEEDED` 时返回；MP4（H.264），有效期 24 小时
`orig_prompt`	string	原始输入提示词
`actual_prompt`	string	开启 `prompt_extend` 时返回的改写后提示词（部分模型不返回）
`code` / `message`	string	仅 `FAILED` 时返回错误码与详情

usage

不同模型系列的用量字段略有差异，均只对成功结果计数：

字段	类型	适用模型	说明
`duration`	number	wan2.7 / wan2.6 / videoedit / s2v / kf2v / vace	计费视频时长（秒）＝输入时长 + 输出时长
`input_video_duration`	integer	同上	输入视频时长；纯生成类任务为 0，参考生视频/视频编辑按输入视频计入
`output_video_duration`	integer	同上	输出视频时长（秒）
`SR`	integer	同上	输出分辨率档位，如 `480`、`720`、`1080`
`ratio`	string	wan2.7	输出宽高比，如 `16:9`
`size`	string	wan2.6	输出分辨率「宽高」，如 `19201080`
`video_duration`	number	wan2.5 及更早、animate	计费视频时长（秒）
`video_ratio`	string	wan2.5 及更早为「宽*高」；animate 为 `standard` / `pro`	输出规格标识
`video_count`	integer	全部	生成视频数量，固定 1

使用建议

生成耗时通常 1–5 分钟，建议以 15 秒左右的间隔轮询；请勿因等待而重复创建任务。

task_id 与 video_url 有效期均为 24 小时：超期查询返回 UNKNOWN，视频地址过期后自动清除，请及时下载或转存至自有存储。

查询接口默认限流 RPS 20，请控制轮询频率。

09-查询任务

查询任务#

接口定义#

路径参数#

请求头#

请求示例#

响应说明#

处理中（PENDING / RUNNING）#

成功（SUCCEEDED）#

失败（FAILED）#

任务不存在#

响应字段#

output#

usage#

使用建议#