curl --location 'https://maas.qianwenaiapi.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": "pixverse/pixverse-v6-r2v-omni",
"input": {
"media": [
{
"type": "video_url",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4",
"ref_name": "参考视频"
},
{
"type": "image_url",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260320/knsple/wan-r2v-role-frame.jpg",
"ref_name": "男人"
},
{
"type": "image_url",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png",
"ref_name": "咖啡厅"
}
],
"prompt": "@男人 在@咖啡厅 中弹吉他 参考@参考视频"
},
"parameters": {
"resolution": "720P",
"aspect_ratio": "16:9",
"duration": 0,
"audio": true,
"watermark": false
}
}'{
"request_id": "<string>",
"output": {
"task_id": "<string>",
"task_status": "PENDING"
}
}- 模型选型：
pixverse/pixverse-c1-r2v适用于打斗、法术特效及高速运动等动态场景以及多宫格场景；pixverse/pixverse-v6-r2v通用场景推荐使用。 - 参考图绑定：通过
media数组提供最多 7 张参考图片，在提示词中使用@ref_name精确绑定角色或物体。 - 灵活分辨率：支持从 360P 到 1080P 多种分辨率与画面比例（16:9、4:3、1:1、3:4、9:16 等）。
- 音频与水印：可选生成带音频的视频，支持添加"AI生成"水印。
- 可复现结果：通过
seed参数固定随机种子，实现结果复现。
- Python SDK
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os
# 若没有配置环境变量，请用千问AI平台API Key将下行替换为：api_key="sk-xxx"
# 获取API Key：https://platform.qianwenai.com/home/api-keys
api_key = os.getenv("DASHSCOPE_API_KEY")
media = [{'type': 'video_url', 'url': 'https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4', 'ref_name': '参考视频'}, {'type': 'image_url', 'url': 'https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260320/knsple/wan-r2v-role-frame.jpg', 'ref_name': '男人'}, {'type': 'image_url', 'url': 'https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png', 'ref_name': '咖啡厅'}]
def sample_async_call():
# 异步提交视频生成任务
rsp = VideoSynthesis.async_call(api_key=api_key,
model='pixverse/pixverse-v6-r2v-omni',
media=media,
prompt='@男人 在@咖啡厅 中弹吉他 参考@参考视频',
resolution='720P',
aspect_ratio='16:9',
duration=0,
audio=True,
watermark=False)
print(rsp)
if rsp.status_code == HTTPStatus.OK:
print("task_id: %s" % rsp.output.task_id)
else:
print('Failed, status_code: %s, code: %s, message: %s' %
(rsp.status_code, rsp.code, rsp.message))
# 查询任务状态
status = VideoSynthesis.fetch(task=rsp, api_key=api_key)
if status.status_code == HTTPStatus.OK:
print(status.output.task_status)
else:
print('Failed, status_code: %s, code: %s, message: %s' %
(status.status_code, status.code, status.message))
# 等待任务完成
rsp = VideoSynthesis.wait(task=rsp, api_key=api_key)
print(rsp)
if rsp.status_code == HTTPStatus.OK:
print(rsp.output.video_url)
else:
print('Failed, status_code: %s, code: %s, message: %s' %
(rsp.status_code, rsp.code, rsp.message))
if __name__ == '__main__':
sample_async_call()
鉴权
千问AI平台 API Key。详见获取 API Key。
Header 参数
异步处理配置参数。HTTP 请求只支持异步，必须设置为 enable。缺少此请求头将报错："current user api does not support synchronous calls"。
请求内容类型。此参数必须设置为 application/json。
千问AI平台 API Key。详见获取 API Key。
请求体
application/json模型名称。可选值：pixverse/pixverse-v6-r2v-omni（需要图片+视频融合参考生成时推荐）、pixverse/pixverse-c1-r2v（适用于打斗、法术特效及高速运动等动态场景以及多宫格场景）、pixverse/pixverse-v6-r2v（通用场景推荐）、pixverse/pixverse-v5.6-r2v（建议升级至v6）。
输入的基本信息，包括参考图片和提示词。
显示子属性
显示子属性
文本提示词，用来描述生成视频中期望包含的元素和视觉特点。支持中英文，每个汉字/字母占一个字符，超过部分会自动截断。pixverse/pixverse-v6-r2v-omni 不超过 5000 个字符，pixverse/pixverse-c1-r2v 不超过 5000 个字符，pixverse/pixverse-v6-r2v 不超过 2048 个字符，pixverse/pixverse-v5.6-r2v 不超过 2048 个字符。
当在 media 参数中传入参考图时，可以通过 @ref_name 在 prompt 中直接引用该图片。media 中设置的 ref_name 在同一请求内必须全局唯一，且须与 prompt 中的引用一一对应。书写规范：必须在 @ref_name 后保留一个空格作为分隔。
媒体素材列表，用于指定视频生成所需的参考图像或视频。数组的每个元素为一个媒体对象，包含 type 和 url 字段。图像数量：1～7 张。
显示子属性
显示子属性
视频生成参数，如设置视频分辨率、时长、是否生成音频等。
显示子属性
显示子属性
生成视频的时长，单位为秒。
pixverse/pixverse-v6-r2v-omni：有视频参考时必须填0，系统将自动取输入视频中的最长时长；仅图片参考时取值范围为 [1, 15] 之间的整数。pixverse/pixverse-c1-r2v：取值范围为 [1, 15] 之间的整数。pixverse/pixverse-v6-r2v：取值范围为 [1, 15] 之间的整数。pixverse/pixverse-v5.6-r2v：当 size 为 360P/540P/720P 时，取值为 5、8、10；当 size 为 1080P 时，取值为 5、8。
生成视频的分辨率档位。仅 pixverse/pixverse-v6-r2v-omni 使用此参数（omni 模型必选）。
生成视频的宽高比。仅 pixverse/pixverse-v6-r2v-omni 使用此参数（omni 模型必选）。auto 表示自动采用第一个图片或视频的宽高比。
生成视频的分辨率，格式为 宽*高 的像素值。c1/v6/v5.6 模型必选，不支持 pixverse/pixverse-v6-r2v-omni 模型（omni 使用 resolution + aspect_ratio）。
pixverse/pixverse-c1-r2v 支持的分辨率：
- 360P：
640*360(16:9)、640*480(4:3)、640*640(1:1)、480*640(3:4)、360*640(9:16)、640*432(3:2)、432*640(2:3)、640*288(21:9) - 540P：
1024*576、1024*768、1024*1024、768*1024、576*1024、1024*688、688*1024、1024*448 - 720P：
1280*720、1108*832、960*960、832*1108、720*1280、1200*800、800*1200、1280*560 - 1080P：
1920*1080、1664*1248、1440*1440、1248*1664、1080*1920、1776*1184、1184*1776、1920*832
pixverse/pixverse-v6-r2v 支持的分辨率：
- 360P：
640*360(16:9)、640*480(4:3)、640*640(1:1)、480*640(3:4)、360*640(9:16)、640*432(3:2)、432*640(2:3)、640*288(21:9) - 540P：
1024*576、1024*768、1024*1024、768*1024、576*1024、1024*688、688*1024、1024*448 - 720P：
1280*720、1108*832、960*960、832*1108、720*1280、1200*800、800*1200、1280*560 - 1080P：
1920*1080、1664*1248、1440*1440、1248*1664、1080*1920、1776*1184、1184*1776、1920*832
pixverse/pixverse-v5.6-r2v 支持的分辨率（建议升级至v6）：
- 360P：
640*360(16:9)、640*480(4:3)、640*640(1:1)、480*640(3:4)、360*640(9:16) - 540P：
1024*576、1024*768、1024*1024、768*1024、576*1024 - 720P：
1280*720、1108*830(4:3)、960*960、830*1108(3:4)、720*1280 - 1080P：
1920*1080、1662*1246(4:3)、1440*1440、1246*1662(3:4)、1080*1920
是否生成有声视频。开启后模型将根据视频内容自动生成匹配的背景音乐或音效。false（默认值）：输出无声视频；true：输出有声视频。
是否添加水印标识，水印位于视频右下角，文案固定为"AI生成"。false（默认值）：不添加水印；true：添加水印。
随机数种子，取值范围为 [0, 2147483647]。未指定时系统自动生成随机种子。若需提升生成结果的可复现性，建议固定 seed 值。由于模型生成具有概率性，即使使用相同 seed 也不能保证每次生成结果完全一致。