Wan 2.7 — 查询结果

GET

/tasks/{task_id}

cURL - 查询任务结果

# 将 {task_id} 替换为提交任务时返回的实际任务 ID
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "2ca1c497-f9e0-449d-9a3f-xxxxxx",
  "output": {
    "task_id": "af6efbc0-4bef-4194-8246-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-25 11:07:28.590",
    "scheduled_time": "2025-09-25 11:07:35.349",
    "end_time": "2025-09-25 11:17:11.650",
    "orig_prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A boy made of spray paint comes to life on a concrete wall. He sings an English rap song at high speed while striking a classic, energetic rapper pose. The scene is set under an urban railway bridge at night. The light comes from a single street lamp, creating a cinematic atmosphere full of high energy and amazing detail. The audio of the video consists entirely of his rap, with no other dialogue or noise.",
    "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx"
  },
  "usage": {
    "duration": 15,
    "input_video_duration": 0,
    "output_video_duration": 15,
    "video_count": 1,
    "SR": 720
  }
}

查询任务状态并获取生成的视频。

轮询策略

通过创建任务接口提交任务，保存返回的 task_id。
每 15 秒轮询一次，直到 task_status 变为 SUCCEEDED 或 FAILED。
任务成功后，从 video_url 下载视频。

注意事项

URL 有效期：video_url 在 24 小时后过期，请及时下载。
状态流转：PENDING → RUNNING → SUCCEEDED、FAILED 或 CANCELED。UNKNOWN 表示任务不存在或查询已超过 24 小时。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

路径参数

string

必填

POST 响应中返回的任务 ID。

响应

200-application/json

string

请求 ID，用于排查问题。联系支持时请提供此 ID。

示例:2ca1c497-f9e0-449d-9a3f-xxxxxx

object

显示子属性

string

任务 ID，提交后 24 小时内可查询。

示例:af6efbc0-4bef-4194-8246-xxxxxx

enum<string>

任务生命周期：PENDING → RUNNING → SUCCEEDED 或 FAILED。主动停止时为 CANCELED，过期后为 UNKNOWN。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

string

任务提交时间（UTC+8，格式：YYYY-MM-DD HH:mm:ss.SSS）。

示例:2025-09-25 11:07:28.590

string

任务开始执行时间（UTC+8，格式：YYYY-MM-DD HH:mm:ss.SSS）。

示例:2025-09-25 11:07:35.349

string

任务结束时间（UTC+8，格式：YYYY-MM-DD HH:mm:ss.SSS），仅在 SUCCEEDED 或 FAILED 状态下出现。

示例:2025-09-25 11:17:11.650

string

原始提示词文本，对应请求参数 prompt。

string

生成视频的 URL（MP4，H.264 编码），仅在 task_status 为 SUCCEEDED 时出现。有效期 24 小时，请及时下载。

示例:https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx

string

错误码，仅在 task_status 为 FAILED 时出现。

string

错误信息，仅在 task_status 为 FAILED 时出现。

object

资源消耗信息，仅在 task_status 为 SUCCEEDED 时出现。

显示子属性

integer

计费视频时长（秒）。

integer

输入视频时长（秒），首帧任务时为 0。

integer

输出视频时长（秒）。

integer

生成的视频数量，固定为 1。

integer

所用分辨率档位（例如，720 对应 720P，1080 对应 1080P）。

​轮询策略

​注意事项

鉴权

路径参数

响应

轮询策略

注意事项