Wan v2 — 查询结果

GET

/tasks/{task_id}

cURL - Query task result

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

{
  "request_id": "815505c6-7c3d-49d7-b197-xxxxxx",
  "output": {
    "task_id": "f470bbfd-d955-4165-935b-d35b8exxxxxx",
    "task_status": "SUCCEEDED",
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            {
              "image": "https://dashscope-463f.oss-accelerate.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
              "type": "image"
            }
          ]
        }
      }
    ],
    "finished": true,
    "submit_time": "2026-01-09 17:18:17.901",
    "scheduled_time": "2026-01-09 17:18:17.941",
    "end_time": "2026-01-09 17:18:45.544"
  },
  "usage": {
    "image_count": 1,
    "input_tokens": 0,
    "output_tokens": 0,
    "size": "1280*1280",
    "total_tokens": 0
  }
}

查询任务状态并获取生成的图像。

轮询策略

通过生成图像接口提交任务，获取 task_id。
每 5 秒轮询一次，直到 task_status 为 SUCCEEDED、FAILED 或 CANCELLED。
任务成功后，从响应中获取图像。

响应格式差异

不同模型的响应格式有所不同：

wan2.6-t2i：结果采用 chat completion 格式：output.choices[].message.content[].image。
wan2.5 及更早版本：结果采用 output.results[].url 格式，包含 orig_prompt 和 actual_prompt 字段。

注意事项

URL 有效期：生成的图像 URL 有效期为 24 小时，请及时下载。
任务状态流转：PENDING → RUNNING → SUCCEEDED、FAILED 或 CANCELLED。
任务 ID 有效期：task_id 有效期为 24 小时，过期后无法查询状态和结果。
避免重复提交：请通过轮询获取结果，不要重复提交创建任务请求。

鉴权

string

header

必填

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

路径参数

string

必填

文生图创建端点返回的任务标识符。

响应

200-application/json

string

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

object

任务输出信息。

显示子属性

string

任务标识符。

enum<string>

当前任务状态。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELLED

object[]

输出内容（wan2.6-t2i 格式），当 task_status 为 SUCCEEDED 时返回。

显示子属性

string

任务停止原因，stop 表示正常完成。

object

显示子属性

string

角色，始终为 assistant。

object[]

显示子属性

string

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

string

内容类型，始终为 image。

object[]

输出内容（wan2.5 及更早版本格式），当 task_status 为 SUCCEEDED 时返回。

显示子属性

string

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

string

原始输入提示词。

string

生成时实际使用的优化后提示词（仅在开启提示词扩写时返回）。

string

错误码（仅当单张图像生成失败时返回）。

string

错误信息（仅当单张图像生成失败时返回）。

boolean

任务是否已完成（wan2.6 格式）。

string

任务提交时间。

string

任务调度时间。

string

任务完成时间。

object

任务结果统计信息。

显示子属性

integer

任务总数。

integer

成功任务数。

integer

失败任务数。

string

错误码（仅当任务失败时返回）。

string

错误信息（仅当任务失败时返回）。

object

用量统计信息，仅统计成功结果。

显示子属性

integer

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

string

生成图像的分辨率。

integer

输入 token 数量（wan2.6 格式）。

integer

输出 token 数量（wan2.6 格式）。

integer

Token 总量（wan2.6 格式）。

​轮询策略

​响应格式差异

​注意事项

鉴权

路径参数

响应

轮询策略

响应格式差异

注意事项