请求参数 Content-Typestring（必选） 请求内容类型。此参数必须设置为application/json。 Authorizationstring（必选） 请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值：Bearer sk-xxxx。 X-DashScope-Asyncstring（必选） 异步处理配置参数。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
模型选型
- 针对打斗、法术特效及高速运动等动态场景，推荐选用 c1。
- 通用场景推荐使用v6，v5.6建议直接升级至v6。
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。 图像限制：
- 格式：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：
- 当 resolution 为 360P / 540P / 720P 对应的所有分辨率时：取值为5、8、10。
- 当resolution为1080P对应的所有分辨率时：取值为5、8。
audio boolean （可选） 重要audio直接影响费用，请在调用前确认模型价格。 是否生成有声视频。开启后模型将根据视频内容自动生成匹配的背景音乐或音效。
false：默认值，输出无声视频。true：输出有声视频。 watermark boolean （可选） 是否添加水印标识，水印位于视频右下角，文案固定为"AI生成"。
false：默认值，不添加水印。true：添加水印。 shot_type string （可选） 支持模型：pixverse/pixverse-v6-it2v。 指定生成视频的镜头类型，控制视频是由一个连续镜头还是多镜头组成。
single：默认值，生成单镜头视频。multi：多镜头，系统会进行智能分镜。 使用建议：prompt 参数优先级高于 shot_type 。为获得最佳效果，建议此参数设置与 prompt 描述保持一致。
- 若想稳定输出单镜头：设置
shot_type="single" 并在 prompt 中描述单镜头场景。
- 若想稳定输出多镜头：设置
shot_type="multi" 并在 prompt 中描述多镜头场景。
seedinteger（可选） 随机数种子，取值范围为[0, 2147483647]。 未指定时，系统自动生成随机种子。若需提升生成结果的可复现性，建议固定seed值。 请注意，由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致。 | 图生视频支持模型：pixverse/pixverse-c1-it2v、pixverse/pixverse-v6-it2v、pixverse/pixverse-v5.6-it2v。 # 调用时请将 {WorkspaceId} 替换为真实的业务空间ID。
curl --location 'https://{WorkspaceId}.cn-beijing.maas.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
}
}'
Python SDKfrom http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os
# 若没有配置环境变量，请用百炼API Key将下行替换为：api_key="sk-xxx"
# 获取API Key：https://help.aliyun.com/zh/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")
media = [{'type': 'image_url', 'url': 'https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp'}]
def sample_async_call():
# 异步提交视频生成任务
rsp = VideoSynthesis.async_call(api_key=api_key,
model='pixverse/pixverse-c1-it2v',
media=media,
prompt='镜头从海龟下方缓缓上移，海龟悠然游动，腹部细节清晰可见。',
resolution='720P',
duration=5,
audio=False,
watermark=True)
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()
图生视频（多镜头）pixverse-c1支持模型：pixverse/pixverse-c1-it2v。 在prompt中描述多镜头场景即可，不支持设置 shot_type参数。 # 调用时请将 {WorkspaceId} 替换为真实的业务空间ID。
curl --location 'https://{WorkspaceId}.cn-beijing.maas.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， 即可生成有声多镜头视频。 # 调用时请将 {WorkspaceId} 替换为真实的业务空间ID。
curl --location 'https://{WorkspaceId}.cn-beijing.maas.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
}
}'
|
