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

声音设计

HappyHorse

HappyHorse -- 参考生视频

提交 HappyHorse 参考生视频任务

POST

/services/aigc/video-generation/video-synthesis

cURL - 参考生视频（多图像）

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "happyhorse-1.1-r2v",
  "input": {
    "prompt": "[Image 1]中身着红色旗袍的女性，镜头先以侧面中景勾勒旗袍修身剪裁与S型曲线，随即切换至低角度仰拍，捕捉她轻抬玉手展开[Image 2]中的折扇的同时，[Image 3]中的流苏耳坠随头部转动轻盈摆动的细节，最后推近至面部特写，定格在她指尖轻点扇骨、眼波流转间的含蓄风情，多视角全方位展现东方韵味。",
    "media": [
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mvzfud/hh-v2v-girl.jpg"
      },
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/fvuihk/hh-v2v2-folding-fan.jpg"
      },
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/imerii/hh-v2v-earrings.jpg"
      }
    ]
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5
  }
}'

{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}

传入多张参考图像，通过文本提示词描述场景，将图像中的主体角色融合生成一段流畅的视频，最长 15 秒，支持 1080P 分辨率。在 prompt 中使用 character1、character2 等标识指代 media 数组中对应位置的参考图像。

鉴权

string

header

必填

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

Header 参数

enum<string>

必填

必须设置为 enable，表示异步提交任务。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。可选值：happyhorse-1.1-r2v、happyhorse-1.0-r2v。

可选值：happyhorse-1.1-r2v,happyhorse-1.0-r2v

示例:happyhorse-1.1-r2v

object

必填

输入的基本信息，包括参考图像和提示词。

显示子属性

string

必填

文本提示词，用来描述生成视频中期望包含的元素和视觉特点。在 prompt 中通过 [Image 1]、[Image 2] 等标识指代 media 数组中对应位置的参考图像，顺序与 media 数组顺序一致。使用时需要指明参考图中的具体对象，例如"[Image 1]中身着红色旗袍的女性"。支持任何语言输入，长度不超过5000个非中文字符或2500个中文字符，超过部分会自动截断。

示例:[Image 1]中身着红色旗袍的女性，优雅站立。

object[]

必填

媒体素材列表（1-9张参考图像）。数组中的第 1 个 reference_image 对应 [Image 1]，第 2 个对应 [Image 2]，以此类推。

取值范围：items: 1–9

显示子属性

enum<string>

必填

媒体素材类型。固定值：reference_image（参考图像）。

可选值：reference_image

string

必填

参考图像 URL 或 Base64 编码数据。

图像限制：格式：JPEG、JPG、PNG、WEBP。分辨率：短边不低于 400 像素，推荐 720P 以上清晰图。文件大小：不超过 20 MB。

支持的输入格式：

公网 URL：支持 HTTP 或 HTTPS 协议。
Base64 编码：格式为 data:{MIME_type};base64,{base64_data}。

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 格式）。

​轮询策略

​响应格式差异

​注意事项

鉴权

路径参数

响应

鉴权

Header 参数

请求体

响应

轮询策略

响应格式差异

注意事项