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": "wan2.7-videoedit",
"input": {
"prompt": "Convert the entire scene to a claymation style",
"media": [
{
"type": "video",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
}
]
},
"parameters": {
"resolution": "720P",
"prompt_extend": true,
"watermark": true
}
}'复制
{
"request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
"output": {
"task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
"task_status": "PENDING"
}
}使用文本提示和可选的参考图片编辑最高 1080P 的视频——支持更改风格、替换对象，或将参考图片中的内容融入源视频。
鉴权
string
header
必填
千问云 API Key。详见获取 API Key。
Header 参数
enum<string>
必填
异步任务提交时必须设置为 enable。
可选值：enable
请求体
application/jsonenum<string>
必填
模型标识符，固定值为 wan2.7-videoedit。
可选值：wan2.7-videoedit
示例:wan2.7-videoedit
object
必填
视频编辑的输入内容。
显示子属性
显示子属性
object[]
必填
编辑所需的媒体素材，每个元素包含 type 和 url 字段。
- video（必填，最多 1 个）：待编辑的视频。格式：MP4、MOV。时长：2-10 秒。分辨率：宽高均在 [240, 4096] 像素范围内。宽高比：1:8 至 8:1。文件大小：最大 100 MB。仅支持 HTTP/HTTPS URL。
- reference_image（可选，最多 4 个）：用于风格或内容迁移的参考图片。格式：JPEG、JPG、PNG（不含 Alpha 通道）、BMP、WEBP。分辨率：宽高均在 [240, 8000] 像素范围内。宽高比：1:8 至 8:1。文件大小：最大 20 MB。支持 HTTP/HTTPS URL 和 Base64 编码数据（
data:{MIME_type};base64,{base64_data}）。
显示子属性
显示子属性
enum<string>
必填
媒体类型。
video：待编辑的视频（必填，最多 1 个）。reference_image：参考图片（可选，最多 4 个）。
可选值：video,reference_image
string
必填
URL 或 Base64 编码数据。
视频（type=video）：仅支持公开 URL（HTTP/HTTPS）。
图片（type=reference_image）：支持公开 URL（HTTP/HTTPS）或 Base64 字符串，格式为 data:{MIME_type};base64,{base64_data}。支持的 MIME 类型：image/jpeg、image/png、image/bmp、image/webp。
string
描述您希望进行的编辑操作，支持中英文，最多 5,000 个字符（超出自动截断）。
示例:Convert the entire scene to a claymation style
string
描述不希望出现在视频中的内容（如 低质量、模糊、多余手指），支持中英文，最多 500 个字符（超出自动截断）。
示例:low resolution, error, worst quality, low quality, incomplete, extra fingers, poor proportions
object
视频编辑参数。
显示子属性
显示子属性
enum<string>
默认值"1080P"
视频清晰度档位，分辨率越高费用越高。
实际输出尺寸取决于 ratio 参数：
- 720P：16:9=1280x720，9:16=720x1280，1:1=960x960，4:3=1104x832，3:4=832x1104
- 1080P：16:9=1920x1080，9:16=1080x1920，1:1=1440x1440，4:3=1648x1248，3:4=1248x1648
可选值：720P,1080P
enum<string>
输出视频的宽高比。如不填写，将沿用输入视频的宽高比。
可选值：16:9,9:16,1:1,4:3,3:4
integer
默认值0
输出视频时长（秒）。0（默认）：使用输入视频的完整时长，不截断。2-10：将输入视频截断至指定时长。
取值范围：0 <= x <= 10
enum<string>
默认值"auto"
输出视频的音频处理方式。
auto（默认）：由模型根据prompt决定。若提示词描述了声音，则可能重新生成音频；否则保留原始音频。origin：始终保留原始音频，不进行重新生成。
可选值：auto,origin
boolean
默认值true
在生成前使用大语言模型对提示词进行改写扩展，可改善简短或模糊提示词的生成效果，但会增加延迟。设为 false 则直接使用原始提示词。
boolean
默认值false
在视频右下角添加「AI 生成」水印。
integer
用于复现结果的随机种子。相同的种子与参数可生成相似（非完全相同）的输出。
取值范围：0 <= x <= 2147483647
