Wan — 查询结果

查询视频人物换脸任务状态

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": "c1209113-8437-424f-a386-xxxxxx",
  "output": {
    "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-25 01:36:21.497",
    "scheduled_time": "2026-03-25 01:36:30.247",
    "end_time": "2026-03-25 01:37:31.910",
    "results": {
      "video_url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx"
    }
  },
  "usage": {
    "video_duration": 5.2,
    "video_ratio": "standard"
  }
}

查询视频人物换脸任务的状态并获取结果。

轮询策略

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

注意事项

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

鉴权

string

header

必填

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

路径参数

string

必填

待查询的任务 ID。

响应

200-application/json

string

唯一请求标识符，用于追踪和排查问题。

示例:a67f8716-18ef-447c-a286-xxxxxx

object

任务输出信息。

显示子属性

string

任务 ID。有效期 24 小时。

示例:0385dc79-5ff8-4d82-bcb6-xxxxxx

enum<string>

当前任务状态。状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。CANCELED 表示任务已取消。UNKNOWN 表示任务不存在或查询已超过 24 小时。

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

string

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

示例:2025-09-18 15:32:00.105

string

任务开始运行的时间，UTC+8，格式为 YYYY-MM-DD HH:mm:ss.SSS。

示例:2025-09-18 15:32:15.066

string

任务完成时间，UTC+8，格式为 YYYY-MM-DD HH:mm:ss.SSS。

示例:2025-09-18 15:34:41.898

object

任务结果。仅在 task_status 为 SUCCEEDED 时返回。

显示子属性

string

生成视频的 URL，MP4 格式（H.264 编码）。有效期 24 小时，请及时下载。

示例:http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx

string

错误码。仅在任务失败时返回。

string

详细错误信息。仅在任务失败时返回。

object

用量统计。仅在任务成功时返回。

显示子属性

number

生成视频的时长，单位为秒。

示例:5.2

enum<string>

所使用的模型服务模式。standard 对应 wan-std；pro 对应 wan-pro。

可选值：standard,pro

​轮询策略

​注意事项

鉴权

路径参数

响应

轮询策略

注意事项