请求参数 请求头（Headers） 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 （必选） 模型名称。 可选值：
kling/kling-v3-turbo-video-generationkling/kling-v3-video-generationkling/kling-v3-omni-video-generation input object （必选） 输入的基本信息，如提示词、媒体素材等。 属性 prompt string （条件必填） 文本提示词。用来描述生成视频中期望包含的元素和视觉特点。 支持中英文，每个汉字/字母占一个字符，不超过2500个字符，超过将返回错误。 填写逻辑：
- 当
shot_type=intelligence 时，此参数必填。
- 当
shot_type=customize 时，此参数不生效，请以 multi_prompt 为准。
Omni模型可通过prompt与主体、图片、视频等内容实现多种能力：
- 支持模型：
kling/kling-v3-omni-video-generation。
- 适用任务：参考生视频。
- 引用格式：通过
<<<>>>的格式来指定某个主体、图片、视频，如：<<<element_1>>>、<<<image_1>>>、<<<video_1>>>。
- 引用顺序：按照
media数组顺序定义prompt中引用的顺序。
- 用法示例：
一只<<<element_1>>>在月光下奔跑。
negative_prompt string （可选） 负向提示词，用于描述不希望在结果中出现的内容。不超过2500个字符。
kling/kling-v3-turbo-video-generation 无独立负向提示词能力，该字段不生效（负向描述可写入prompt）。- 支持模型：
kling/kling-v3-video-generation、kling/kling-v3-omni-video-generation。
media array （可选） 文生视频任务无需填写此参数。 媒体素材列表，用于指定图像或视频素材。 不同模型支持的媒体素材搭配不一样： 素材组合规则 kling/kling-v3-turbo-video-generation 仅支持以下媒体素材组合，非法组合将报错。
-
图生视频-基于首帧：first_frame。
- 数量限制：首帧恰好1张。不支持
last_frame。
kling/kling-v3-video-generation kling/kling-v3-omni-video-generation 属性 type string （必选） 媒体素材类型。可选值与所选模型有关： kling/kling-v3-turbo-video-generation 可选值： 不支持last_frame。不同媒体素材之间的搭配限制，请参见 media 参数下的”素材组合规则”。 kling/kling-v3-video-generation 可选值：
first_frame：首帧图片。last_frame：尾帧图片。 不同媒体素材之间的搭配限制，请参见 media 参数下的”素材组合规则”。 kling/kling-v3-omni-video-generation 可选值：
first_frame：首帧图片。last_frame：尾帧图片。refer：参考图片。base：待编辑视频。feature：特征参考视频。 不同媒体素材之间的搭配限制，请参见 media 参数下的“素材组合规则”。 url string （必选） 媒体素材URL。素材包括图像、视频。 传入图像（type=first_frame或last_frame或refer） 图像URL。 图像限制：
- 格式：JPEG、JPG、PNG（不支持透明通道）。
- 分辨率：宽和高的范围为[300, 8000]像素。
- 宽高比：1:2.5 ~ 2.5:1。
- 文件大小：不超过10MB。
传入视频（type=base或feature） 视频文件的 URL。 视频限制：
- 格式：mp4、mov。
- 文件大小：不超过200MB。
- 时长：3～15.5s。
- 分辨率：宽和高的范围为[700, 4553]像素，像素总面积不超过8294400。
- 宽高比：0.4～2。
- 帧率：24～60fps。
keep_original_sound string （可选） 支持模型：kling/kling-v3-omni-video-generation 。 生效条件：当且仅当传入视频（type=base或feature）时生效。 是否保留原视频声音。 multi_shot boolean （可选） 是否开启多镜头生成。
false：默认值，不开启多镜头。true：开启多镜头生成。 注意：
- 视频特征参考（feature）场景支持开启多镜头（
shot_type仅支持intelligence）。
- 视频编辑（base）场景不支持多镜头。
shot_type string （条件必填） 当multi_shot=true 时必填。多镜头模式类型。
intelligence：智能分镜，由模型自动规划镜头。customize：自定义模式，支持自定义每个片段的提示词和时长。 multi_prompt array （条件必填） 当shot_type=customize 时必填。多镜头自定义模式下的片段列表。 属性 index integer （必选） 分镜片段索引，分镜数量为1～6个，索引从1开始。 prompt string （必选） 对应片段的提示词，支持中英文，不超过512个字符，超过自动截断。 duration integer （必选） 对应片段的时长，单位为秒。 取值为[1, parameters.duration]之间的整数。 element_list array （可选） 主体列表，用于指定视频中需要引入的主体元素。 注意：kling/kling-v3-turbo-video-generation 不支持主体，该字段不可传。 属性 element_id integer （条件必填） 传element_list时必填，表示主体ID。请在可灵-主体ID列表获取主体ID。 主体个数限制（element_list数组长度限制）：
- 图生视频-基于首帧：最多支持3个主体。
- 图生视频-基于首尾帧：最多支持3个主体。
- 参考生视频（
type=refer）：参考图片与多图主体数量之和不得超过7。
- 参考生视频（
type=feature+refer）：参考图片与多图主体数量之和不得超过4。
- 视频输入场景（omni模型）：支持视频类型主体，最多1个。引用视频类型主体后，不可再传参考图/图片类型主体。
parameters object （可选） 视频生成参数。如设置生成模式、画面比例、视频时长、是否生成音频等。 属性 mode string （可选） 视频生成模式。
pro：默认值，专业模式，输出视频分辨率为1080P。std：标准模式，输出视频分辨率为720P。4k：4K模式，输出视频分辨率为4K。 注意：kling/kling-v3-turbo-video-generation 仅支持std（720P）和pro（1080P），不支持4K。 aspect_ratio string （条件必填） 生成视频的宽高比例。 可选值： 以下场景必须填写：
- 文生视频：必须设置。
- 参考生视频（
type=feature、type=feature+refer、type=refer）：必须设置。
其他场景无需设置
- 图生视频-基于首帧：以首帧的宽高比为基准，无需填写。
- 图生视频-基于首尾帧：以首帧的宽高比为基准，无需填写。
- 参考生视频（
type=feature+first_frame）：以首帧的宽高比为基准，无需填写。
- 视频编辑：以输入视频的宽高比为基准，无需填写。
duration integer （可选） 重要duration直接影响费用，按秒计费，时间越长费用越高，请前往百炼控制台查看价格。 生成视频的时长，单位为秒。
-
kling/kling-v3-turbo-video-generation：取值为[3, 15]之间的整数，默认值为5。
-
kling/kling-v3-video-generation：取值为[3, 15]之间的整数，默认值为5。
-
kling/kling-v3-omni-video-generation：取值为[3, 15]之间的整数，默认值为5。
示例值：5。 audio boolean （可选） 重要audio直接影响费用，请前往百炼控制台查看价格。 是否生成有声视频。开启后模型将根据视频内容自动生成匹配的背景音乐或音效。
false：默认值，输出无声视频。true：输出有声视频。 注意：
- 当传入视频（
type=base或feature）时，audio只能设置为false。
kling/kling-v3-turbo-video-generation 固定生成音画同出视频，该字段不生效（恒为生成）。 watermark boolean （可选） 是否同时生成含水印的视频。水印位于视频右下角，文案固定为”可灵AI”。设置为true时，响应中将额外返回watermark_video_url字段。
false：默认值，不生成含水印的视频。true：同时生成含水印的视频。 | 文生视频支持模型：kling/kling-v3-turbo-video-generation、kling/kling-v3-video-generation、kling/kling-v3-omni-video-generation。 # 以下为华北2（北京）地域的URL。请将 {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": "kling/kling-v3-turbo-video-generation",
"input": {
"prompt": "一只小猫在月光下奔跑"
},
"parameters": {
"mode": "std",
"aspect_ratio": "16:9",
"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")
def sample_async_call():
# 异步提交视频生成任务
rsp = VideoSynthesis.async_call(api_key=api_key,
model='kling/kling-v3-turbo-video-generation',
prompt='一只小猫在月光下奔跑',
mode='std',
aspect_ratio='16:9',
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()
文生视频（智能分镜）支持模型：kling/kling-v3-turbo-video-generation、kling/kling-v3-video-generation、kling/kling-v3-omni-video-generation。 # 以下为华北2（北京）地域的URL。请将 {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": "kling/kling-v3-video-generation",
"input": {
"prompt": "",
"multi_shot": true,
"shot_type": "customize",
"multi_prompt": [
{
"index": 1,
"prompt": "雾岭镇比地图上更小，山雾像棉絮一样堵在街口。邮局背后果然有三棵槐树，第三棵树根旁的泥土被人动过。",
"duration": 5
},
{
"index": 2,
"prompt": "林澈蹲下挖出一个铁盒，里面除了一把生锈的钥匙，还有一盘老旧的录音带。录音机是邮局借的，按下播放键时，父亲的声音从沙沙杂音里爬出来：“如果你听到这段话，说明你已经走到我走过的路上了。",
"duration": 5
}
],
"media": [],
"element_list": []
},
"parameters": {
"mode": "pro",
"duration": 10,
"audio": true,
"aspect_ratio": "9:16",
"watermark": true
}
}'
图生视频（首帧生视频）支持模型：kling/kling-v3-turbo-video-generation、kling/kling-v3-video-generation、kling/kling-v3-omni-video-generation。 # 以下为华北2（北京）地域的URL。请将 {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": "kling/kling-v3-omni-video-generation",
"input": {
"prompt": "让图片中的人物动起来，头发被微风吹动",
"media": [
{
"type": "first_frame",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp"
}
]
},
"parameters": {
"mode": "std",
"duration": 5,
"audio": false,
"watermark": true
}
}'
图生视频（首尾帧生视频）支持模型：kling/kling-v3-video-generation、kling/kling-v3-omni-video-generation。 # 以下为华北2（北京）地域的URL。请将 {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": "kling/kling-v3-omni-video-generation",
"input": {
"prompt": "写实风格，一只黑色小猫好奇地看向天空，镜头从平视逐渐上升，最后俯拍它的好奇的眼神。",
"media": [
{
"type": "first_frame",
"url": "https://wanx.alicdn.com/material/20250318/first_frame.png"
},
{
"type": "last_frame",
"url": "https://wanx.alicdn.com/material/20250318/last_frame.png"
}
]
},
"parameters": {
"mode": "std",
"duration": 5,
"audio": false,
"watermark": true
}
}'
参考生视频（视频+图像）支持模型：kling/kling-v3-omni-video-generation。 # 以下为华北2（北京）地域的URL。请将 {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": "kling/kling-v3-omni-video-generation",
"input": {
"prompt": "<<<element_1>>>背景，<<<image_2>>>和<<<image_1>>>握手交谈，<<<video_1>>>人物穿着黑色风衣的侦探站在公寓楼顶，手持望远镜观察街道",
"multi_shot": false,
"shot_type": "intelligence",
"multi_prompt": [],
"media": [
{
"url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/lip_sync_5s.mp4",
"type": "base",
"keep_original_sound": "yes"
},
{
"type": "refer",
"url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/zem_test/yangmi01.jpg"
},
{
"type": "refer",
"url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/human_2.JPG"
}
],
"element_list": [
{
"element_id": 171
}
]
},
"parameters": {
"mode": "pro",
"duration": 10,
"audio": false,
"aspect_ratio": "1:1",
"watermark": true
}
}'
|
