Vidu — 创建任务

POST

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

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": "vidu/viduq2_reference2video",
  "input": {
    "media": [
      {
        "type": "image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260320/knsple/wan-r2v-role-frame.jpg"
      },
      {
        "type": "image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
      },
      {
        "type": "image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
      }
    ],
    "prompt": "男人坐在靠窗的椅子上，手持吉他，在咖啡厅旁演奏一首舒缓的美国乡村民谣"
  },
  "parameters": {
    "duration": 5,
    "size": "1280*720",
    "resolution": "720P",
    "watermark": true
  }
}'

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

生成保留参考图片或视频中主体外观的视频。

可用模型

模型	参考输入	最大时长
`vidu/viduq2_reference2video`	1–7 张图片	10 秒
`vidu/viduq2-pro_reference2video`	1–4 张图片 + 0–2 段视频	10 秒

图片要求

格式：JPEG、JPG、PNG 或 WEBP
宽高比：1:4 到 4:1 之间
文件大小：每张图片不超过 50 MB

视频要求（仅 pro 模型）

格式：MP4、AVI 或 MOV
最小尺寸：128 × 128 像素
宽高比：1:4 到 4:1 之间
时长：1–5 秒
文件大小：每段视频不超过 50 MB

轮询结果

该 API 为异步接口。提交任务后：

记录响应中的 task_id。
每 15 秒轮询一次查询视频结果。
当 task_status 为 SUCCEEDED 时，从 output.video_url 获取视频。

鉴权

string

header

必填

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

Header 参数

enum<string>

必填

异步处理配置参数。HTTP 请求只支持异步，必须设置为 enable。

缺少此请求头将报错："current user api does not support synchronous calls"。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。

| 模型 | 参考输入 | 最大时长 | |------|---------|--------| | vidu/viduq2_reference2video | 1～7 张图像 | 10 秒 | | vidu/viduq2-pro_reference2video | 1～4 张图像 + 0～2 个视频 | 10 秒 |

可选值：vidu/viduq2_reference2video,vidu/viduq2-pro_reference2video

示例:vidu/viduq2_reference2video

object

必填

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

显示子属性

string

必填

文本提示词。用来描述生成视频中期望包含的元素和视觉特点。

支持中英文
不超过 5000 个字符，超过部分会自动截断

示例值：男人坐在靠窗的椅子上，手持吉他，在咖啡厅旁演奏一首舒缓的美国乡村民谣。

提示词编写请参见Vidu视频生成Prompt指南。

示例:男人坐在靠窗的椅子上，手持吉他，在咖啡厅旁演奏一首舒缓的美国乡村民谣

object[]

必填

媒体素材列表，用于指定视频生成所需的参考图像或参考视频。

vidu/viduq2_reference2video 模型：

仅支持图像，数量为 1～7 张。
type 固定为 image。

vidu/viduq2-pro_reference2video 模型：

图像：必选，数量为 1～4 张。
视频：可选，数量为 1～2 个。
仅参考图像时，图像数量为 1～7 张。
参考图像和视频同时使用时，图像数量为 1～4 张，视频数量为 1～2 个。

图像限制：

格式：JPEG、JPG、PNG、WEBP
宽高比：1:4～4:1
文件大小：不超过 50MB

视频限制（仅 pro 模型）：

格式：mp4、avi、mov
分辨率：总像素值不小于 128×128
宽高比：1:4～4:1
时长：1～5 秒
文件大小：不超过 50MB

取值范围：items >= 1

显示子属性

enum<string>

必填

媒体素材类型。可选值与模型有关：

image：参考图像
video：参考视频（仅 viduq2-pro_reference2video 模型支持）

可选值：image,video

示例:image

string

必填

媒体素材 URL，必须为公网可访问的 URL，支持 HTTP 或 HTTPS 协议。

示例值：https://xxx/xxx.png

示例:https://example.com/character.jpg

object

视频生成参数。用于设置视频分辨率、时长等。

显示子属性

enum<string>

默认值"720P"

生成视频的分辨率。

resolution 直接影响费用，请在调用前确认模型价格。

可选值：

540P
720P：默认值
1080P

可选值：540P,720P,1080P

示例:720P

string

生成视频的分辨率，格式为宽*高的像素值。

默认值根据 resolution 而定：

resolution=540P 时，size 默认为 960*528
resolution=720P 时，size 默认为 1280*720
resolution=1080P 时，size 默认为 1920*1080

推荐 resolution 和 size 同时传入，以精准控制生成视频的宽高比。

各分辨率档位下 size 的取值：

| 分辨率 | 宽高比 | size 取值 | |--------|--------|----------| | 540P | 16:9 | 960540 | | 540P | 4:3 | 720540 | | 540P | 1:1 | 540540 | | 540P | 3:4 | 540720 | | 540P | 9:16 | 540960 | | 720P | 16:9 | 1280720 | | 720P | 4:3 | 960720 | | 720P | 1:1 | 720720 | | 720P | 3:4 | 720960 | | 720P | 9:16 | 7201280 | | 1080P | 16:9 | 19201080 | | 1080P | 4:3 | 14401080 | | 1080P | 1:1 | 10801080 | | 1080P | 3:4 | 10801440 | | 1080P | 9:16 | 1080*1920 |

示例:1280*720

integer

默认值5

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

duration 直接影响费用，按秒计费，请在调用前确认模型价格。

vidu/viduq2-pro_reference2video：

取值为 [1, 10] 之间的整数，默认值为 5
支持设置为 0，表示自动规划时长，上限不超过 10 秒
若上传 1 个参考视频：生成视频时长通常等于该参考视频时长
若上传 2 个参考视频：生成视频时长通常等于"主要参考视频"的时长

vidu/viduq2_reference2video：

取值为 [1, 10] 之间的整数，默认值为 5

示例:5

取值范围：0 <= x <= 10

boolean

默认值false

是否添加水印标识，水印位于视频右下角，文案固定为"内容由 AI 生成"。

false：默认值，不添加水印
true：添加水印

示例:false

integer

随机数种子，取值范围为 [0, 2147483647]。

未指定时，系统自动生成随机种子。若需提升生成结果的可复现性，建议固定 seed 值。

由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致。

示例值：12345

示例:12345

取值范围：0 <= x <= 2147483647

响应

200-application/json

string

请求唯一标识。可用于请求明细溯源和问题排查。

示例:4909100c-7b5a-9f92-bfe5-xxxxxx

object

任务输出信息。

显示子属性

string

任务 ID。查询有效期 24 小时。用于后续调用 GET /tasks/{task_id} 查询任务状态。

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

enum<string>

任务状态。初始状态通常为 PENDING。

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

示例:PENDING

​可用模型

​图片要求

​视频要求（仅 pro 模型）

​轮询结果

鉴权

Header 参数

请求体

响应

可用模型

图片要求

视频要求（仅 pro 模型）

轮询结果