请求参数 | 图生视频支持模型:pixverse/pixverse-c1-it2v、pixverse/pixverse-v6-it2v、pixverse/pixverse-v5.6-it2v。 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": "pixverse/pixverse-c1-it2v",
"input": {
"media": [
{
"type": "image_url",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp"
}
],
"prompt": "镜头从海龟下方缓缓上移,海龟悠然游动,腹部细节清晰可见。"
},
"parameters": {
"resolution": "720P",
"duration": 5,
"audio": false,
"watermark": true
}
}'
图生视频(多镜头)pixverse-c1支持模型:pixverse/pixverse-c1-it2v。 在prompt中描述多镜头场景即可,不支持设置 shot_type参数。 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": "pixverse/pixverse-c1-it2v",
"input": {
"media": [
{
"type": "image_url",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp"
}
],
"prompt": "镜头1:从海龟下方缓缓上移,海龟悠然游动,腹部细节清晰可见。镜头2:远景,海龟旁边围绕着海草,海草也在左右摇摆"
},
"parameters": {
"resolution": "720P",
"duration": 8,
"audio": false,
"watermark": true
}
}'
pixverse-v6支持模型:pixverse/pixverse-v6-it2v。 在prompt中描述多镜头场景,并设置 shot_type 为multi, 即可生成有声多镜头视频。 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": "pixverse/pixverse-v6-it2v",
"input": {
"media": [
{
"type": "image_url",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp"
}
],
"prompt": "镜头1:从海龟下方缓缓上移,海龟悠然游动,腹部细节清晰可见。镜头2:远景,海龟旁边围绕着海草,海草也在左右摇摆"
},
"parameters": {
"resolution": "720P",
"duration": 8,
"shot_type": "multi",
"audio": false,
"watermark": true
}
}'
|
Content-Type string (必选) 请求内容类型。此参数必须设置为application/json。 |
Authorization string(必选) 请求身份认证。接口使用阿里云百炼API-Key进行身份认证。示例值:Bearer sk-xxxx。 |
X-DashScope-Async string (必选) 异步处理配置参数。HTTP请求只支持异步,必须设置为enable。
重要 缺少此请求头将报错:“current user api does not support synchronous calls”。 |
请求体(Request Body) |
model string (必选) 模型名称。模型输出规格请参见模型列表。 可选值: pixverse/pixverse-c1-it2v pixverse/pixverse-v6-it2v pixverse/pixverse-v5.6-it2v
|
input object (必选) 输入的基本信息,如提示词、媒体素材等。 属性 prompt string (可选) 文本提示词。用来描述生成视频中期望包含的元素和视觉特点。 支持中英文,每个汉字/字母占一个字符,字符编码为UTF-8,超过部分会自动截断。 pixverse/pixverse-c1-it2v:不超过5000个字符。 pixverse/pixverse-v6-it2v:不超过5000个字符。 pixverse/pixverse-v5.6-it2v:不超过2048个字符。
media array (必选) 媒体素材列表,用于指定视频生成所需的图像。 数组的每个元素为一个媒体对象,包含 type 与 url 字段。 属性 type string (必选) 媒体素材类型。固定值为: 素材限制:图像数量推荐为1张。 若传入多张图像,系统将默认采用最后一个,建议始终只传一张图像以确保预期效果。 url string (必选) 图像文件的URL地址,必须为公网可访问的URL。 支持 HTTP 或 HTTPS 协议。 示例值:https://xxx/xxx.jpg。
图像限制: 格式:JPG、PNG、WEBP。 分辨率:图像的宽度和高度均不超过10000像素。 文件大小:不超过20MB。
|
parameters object (可选) 视频处理参数,如设置视频分辨率、设置视频时长、开启音频生成、添加水印等。 属性 resolution string (必选)
重要 resolution直接影响费用,请在调用前确认模型价格。 指定生成的视频分辨率档位。 可选值:360P、540P、720P、1080P。 duration integer (必选)
重要 duration直接影响费用,按秒计费,请在调用前确认模型价格。 生成视频的时长,单位为秒。 pixverse/pixverse-c1-it2v:取值范围为[1, 15]之间的整数。 pixverse/pixverse-v6-it2v:取值范围为[1, 15]之间的整数。 pixverse/pixverse-v5.6-it2v:
audio boolean (可选)
重要 audio直接影响费用,请在调用前确认模型价格。 是否生成有声视频。开启后模型将根据视频内容自动生成匹配的背景音乐或音效。 false:默认值,输出无声视频。
true:输出有声视频。
watermark boolean (可选) 是否添加水印标识,水印位于视频右下角,文案固定为"AI生成"。 false:默认值,不添加水印。
true:添加水印。
shot_type string (可选) 支持模型:pixverse/pixverse-v6-it2v。 指定生成视频的镜头类型,控制视频是由一个连续镜头还是多镜头组成。 single:默认值,生成单镜头视频。
multi:多镜头,系统会进行智能分镜。
使用建议:prompt 参数优先级高于 shot_type 。为获得最佳效果,建议此参数设置与 prompt 描述保持一致。 seed integer (可选) 随机数种子,取值范围为[0, 2147483647]。 未指定时,系统自动生成随机种子。若需提升生成结果的可复现性,建议固定seed值。 请注意,由于模型生成具有概率性,即使使用相同 seed,也不能保证每次生成结果完全一致。 |