可灵-视频生成模型支持 文生视频、图生视频-基于首帧、图生视频-基于首尾帧、参考生视频以及视频编辑 。
服务开通
请前往阿里云百炼控制台,搜索“kling”,找到可灵AI模型卡片,单击立即开通,在弹窗内确认开通及授权。
适用范围
为确保调用成功,请务必保证模型、Endpoint URL 和 API Key 均属于同一地域。跨地域调用将会失败。
- 选择模型:确认模型所属的地域。
- 选择 URL:选择对应的地域 Endpoint URL,支持HTTP URL。
- 配置 API Key:选择地域并获取与配置 API Key,再配置API Key到环境变量。
模型概览
模型名称 | 能力支持 | 输入模态 | 输出视频规格 |
|---|---|---|---|
kling/kling-v3-turbo-video-generation |
| 文本、图像 | 分辨率模式:std(720P)、pro(1080P) 宽高比:16:9、9:16、1:1 视频时长:3-15秒 视频格式:MP4 |
kling/kling-v3-video-generation |
| 文本、图像 | 分辨率模式:std(720P)、pro(1080P)、4k 宽高比:16:9、9:16、1:1 视频时长:3-15秒 视频格式:MP4 |
kling/kling-v3-omni-video-generation |
| 文本、图像、视频 | 分辨率模式:std(720P)、pro(1080P)、4k 宽高比:16:9、9:16、1:1 视频时长:3-15秒 视频格式:MP4 |
HTTP调用
由于视频生成任务耗时较长(通常为1-5分钟),API采用异步调用。整个流程包含 "创建任务 -> 轮询获取" 两个核心步骤,具体如下:
步骤1:创建任务获取任务ID
北京地域:POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
调用时请将{WorkspaceId}替换为真实的业务空间ID。
- 创建成功后,使用接口返回的
task_id查询结果,task_id 有效期为 24 小时。请勿重复创建任务,轮询获取即可。 - 新手指引请参见Postman。
请求参数请求头(Headers)Content-Typestring(必选)请求内容类型。此参数必须设置为application/json。Authorizationstring(必选)请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值:Bearer sk-xxxx。X-DashScope-Asyncstring(必选)异步处理配置参数。HTTP请求只支持异步,必须设置为enable。请求体(Request Body)modelstring (必选)模型名称。可选值:
object (必选)输入的基本信息,如提示词、媒体素材等。
属性 prompt string (条件必填)文本提示词。用来描述生成视频中期望包含的元素和视觉特点。支持中英文,每个汉字/字母占一个字符,不超过2500个字符,超过将返回错误。填写逻辑:
string (可选)负向提示词,用于描述不希望在结果中出现的内容。不超过2500个字符。
array (可选)文生视频任务无需填写此参数。媒体素材列表,用于指定图像或视频素材。不同模型支持的媒体素材搭配不一样:
素材组合规则
kling/kling-v3-turbo-video-generation 仅支持以下媒体素材组合,非法组合将报错。
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 可选值:
media 参数下的”素材组合规则”。
kling/kling-v3-omni-video-generation 可选值:
media 参数下的“素材组合规则”。string (必选)媒体素材URL。素材包括图像、视频。
传入图像(type=first_frame或last_frame或refer) 图像URL。
传入视频(type=base或feature) 视频文件的 URL。
string (可选)支持模型:kling/kling-v3-omni-video-generation 。生效条件:当且仅当传入视频(type=base或feature)时生效。是否保留原视频声音。
boolean (可选)是否开启多镜头生成。
string (条件必填)当multi_shot=true 时必填。多镜头模式类型。
array (条件必填)当shot_type=customize 时必填。多镜头自定义模式下的片段列表。
属性 index integer (必选)分镜片段索引,分镜数量为1~6个,索引从1开始。prompt string (必选)对应片段的提示词,支持中英文,不超过512个字符,超过自动截断。duration integer (必选)对应片段的时长,单位为秒。取值为[1, parameters.duration]之间的整数。array (可选)主体列表,用于指定视频中需要引入的主体元素。注意:kling/kling-v3-turbo-video-generation 不支持主体,该字段不可传。
属性 element_id integer (条件必填)传element_list时必填,表示主体ID。请在可灵-主体ID列表获取主体ID。主体个数限制(element_list数组长度限制):
object (可选)视频生成参数。如设置生成模式、画面比例、视频时长、是否生成音频等。
属性 mode string (可选)视频生成模式。
kling/kling-v3-turbo-video-generation 仅支持std(720P)和pro(1080P),不支持4K。aspect_ratio string (条件必填)生成视频的宽高比例。可选值:
其他场景无需设置
integer (可选)生成视频的时长,单位为秒。
boolean (可选)是否生成有声视频。开启后模型将根据视频内容自动生成匹配的背景音乐或音效。
boolean (可选)是否同时生成含水印的视频。水印位于视频右下角,文案固定为”可灵AI”。设置为true时,响应中将额外返回watermark_video_url字段。
|
支持模型: kling/kling-v3-turbo-video-generation、kling/kling-v3-video-generation、kling/kling-v3-omni-video-generation。 |
响应参数outputobject任务输出信息。
属性 task_id string任务ID。查询有效期24小时。task_status string任务状态。
枚举值
string请求唯一标识。可用于请求明细溯源和问题排查。codestring请求失败的错误码。请求成功时不会返回此参数,详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误码。 |
请保存 task_id,用于查询任务状态与结果。 |
步骤2:根据任务ID查询结果
北京地域:GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}
请求参数请求头(Headers)Authorizationstring(必选)请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值:Bearer sk-xxxx。URL路径参数(Path parameters)task_idstring(必选)任务ID。 |
将 {task_id}完整替换为上一步接口返回的task_id的值。task_id查询有效期为24小时,并请将{WorkspaceId}替换为真实的业务空间ID。 |
响应参数outputobject任务输出信息。
属性 task_id string任务ID。查询有效期24小时。task_status string任务状态。
枚举值
string任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。scheduled_time string任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。end_time string任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。video_urlstring视频URL。仅在 task_status 为 SUCCEEDED 时返回。视频格式为MP4(H.264 编码)。视频链接有效期30天,但不建议将其作为长期存储依赖,请及时下载。watermark_video_urlstring带水印的视频URL。仅在 task_status 为 SUCCEEDED 时返回。视频格式为MP4(H.264 编码)。视频链接有效期30天,但不建议将其作为长期存储依赖,请及时下载。orig_prompt string原始输入的prompt,对应请求参数prompt。codestring请求失败的错误码。请求成功时不会返回此参数,详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误码。object输出信息统计。只对成功的结果计数。
属性 duration integer生成视频的总视频时长,用于计费。size string生成视频的分辨率。示例值:1280*720。fps integer生成视频的帧率。示例值:24。SR string生成视频的分辨率档位。示例值:720。mode=4k时返回4k;kling/kling-v3-turbo-video-generation仅返回720或1080。audio boolean生成视频是否为有声视频。示例值:false。kling/kling-v3-turbo-video-generation恒为true(固定音画同出)。video_count integer生成视频的数量。固定为1。string请求唯一标识。可用于请求明细溯源和问题排查。 |
|