Wan 2.1 — 查询结果

查询 Wan 2.1 图像编辑任务状态

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": "eeef0935-02e9-9742-bb55-xxxxxx",
  "output": {
    "task_id": "a425c46f-dc0a-400f-879e-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-02-21 17:56:31.786",
    "scheduled_time": "2025-02-21 17:56:31.821",
    "end_time": "2025-02-21 17:56:42.530",
    "results": [
      {
        "url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/aaa.png"
      }
    ],
    "task_metrics": {
      "TOTAL": 1,
      "SUCCEEDED": 1,
      "FAILED": 0
    }
  },
  "usage": {
    "image_count": 1
  }
}

查询任务状态和结果。

轮询策略

通过创建任务接口提交请求，获取 task_id。
每 10 秒轮询一次，直到 task_status 为 SUCCEEDED 或 FAILED。
任务成功后，results 中包含图片下载 URL。

注意事项

URL 有效期：图片 URL 在 24 小时后过期，请及时下载。
任务状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。
其他状态：CANCELED（任务已取消）、UNKNOWN（task_id 无效或已过期）。
task_id 有效期：task_id 有效期为 24 小时，过期后无法查询任务状态和结果。
避免重复提交：请通过轮询获取结果，不要重复提交请求。

鉴权

string

header

必填

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

路径参数

string

必填

创建任务时返回的任务标识符。

响应

200-application/json

string

请求的唯一标识符。

object

显示子属性

string

任务 ID，可在 24 小时内用于查询任务状态。

enum<string>

任务状态。

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

string

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

string

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

string

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

object[]

生成结果数组。每个条目包含图片 URL，或失败时的错误详情。

显示子属性

string

生成图像的 URL，有效期 24 小时。

string

单张图片生成失败的错误码。仅在部分失败时返回。

string

单张图片生成失败的错误信息。仅在部分失败时返回。

object

任务结果统计。

显示子属性

integer

总任务数。

integer

成功数。

integer

失败数。

string

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

string

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

object

用量统计。仅统计成功的结果。

显示子属性

integer

成功生成的图片数量。计费公式：费用 = 图片数量 x 单价。

​轮询策略

​注意事项

鉴权

路径参数

响应

轮询策略

注意事项