curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx2.1-vace-plus",
"input": {
"function": "image_reference",
"prompt": "In the video, a girl gracefully walks out from a misty, ancient forest. Her steps are light, and the camera captures her every nimble moment. When she stops and looks around at the lush woods, a smile of surprise and joy blossoms on her face. This scene, frozen in a moment of interplay between light and shadow, records her wonderful encounter with nature.",
"ref_images_url": [
"http://wanx.alicdn.com/material/20250318/image_reference_2_5_16.png",
"http://wanx.alicdn.com/material/20250318/image_reference_1_5_16.png"
]
},
"parameters": {
"prompt_extend": true,
"obj_or_bg": ["obj","bg"],
"size": "1280*720"
}
}'{
"request_id": "<string>",
"output": {
"task_id": "<string>",
"task_status": "PENDING"
}
}鉴权
千问云 API Key。详见获取 API Key。
Header 参数
必须设置为 enable 以创建异步任务。
请求体
application/json模型名称。
视频编辑的输入数据，各功能所需字段不同。
显示子属性
显示子属性
要使用的视频编辑能力。
对目标视频内容的文字描述。
参考图像 URL 数组。image_reference 功能使用（1-3 张图像），video_repainting 和 video_edit 可选使用（1 张图像，用于替换主体）。
[
"http://wanx.alicdn.com/material/20250318/image_reference_2_5_16.png",
"http://wanx.alicdn.com/material/20250318/image_reference_1_5_16.png"
]输入视频的 URL。video_repainting、video_edit 和 video_outpainting 必填。格式须为 MP4，大小不超过 50 MB，时长不超过 5 秒。
用于 video_edit 的蒙版图像 URL。白色区域将被编辑，黑色区域保持不变。与 mask_video_url 二选一。
用于 video_edit 的蒙版视频 URL。与 mask_image_url 二选一，推荐使用 mask_image_url。
用于带 mask_image_url 的 video_edit：指定蒙版对应的视频帧索引。默认为第一帧（0）。
用于 video_extension：第一段视频片段的 URL（不超过 3 秒）。模型将基于此片段生成后续内容。
用于 video_extension：最后一段视频片段的 URL（不超过 3 秒）。模型将生成其前面的内容。
用于 video_extension：首帧图像的 URL，视频将从该帧向后延伸生成。
用于 video_extension：末帧图像的 URL，视频将从该帧向前追溯生成。
视频编辑的生成参数，可用参数因功能而异。
显示子属性
显示子属性
启用提示词改写。true（默认）：模型自动优化提示词；false：原样使用提示词。video_repainting 时建议关闭此项。
输出分辨率，格式为 宽*高。用于 image_reference 和 video_edit。
用于 image_reference：标识每张参考图像为主体（obj）或背景（bg）。数组长度须与 ref_images_url 一致。
[
"obj",
"bg"
]用于 video_repainting：视频特征提取方式，决定保留原视频中的哪些特征。
用于 video_repainting：控制特征提取强度。值越高，输出越接近原视频；值越低，创意空间越大。
用于 video_edit：指定编辑区域的行为。tracking（默认）：编辑区域自动跟随目标运动；fixed：编辑区域固定不动。
用于带 mask_type: tracking 的 video_edit：蒙版区域向外扩展的比例。值越小越贴合目标，值越大扩展范围越广。
用于 video_outpainting：向上扩展比例。设为 1.5 时，顶部扩展至原高度的 1.5 倍。
用于 video_outpainting：向下扩展比例。
用于 video_outpainting：向左扩展比例。
用于 video_outpainting：向右扩展比例。
