3.0 图生视频
Header Parameters
格式: Authorization: Bearer sk-xxxxxx
Request Body
application/json
生成视频时长,单位s ● 枚举值:3,4,5,6,7,8,9,10,11,12,13,14,15 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图
文本提示词,可包含正向描述和负向描述 ● 可将提示词模板化来满足不同的视频生成需求 Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力 ○ 通过<<<>>>的格式来指定某个主体、图片、视频,如:<<<element_1>>>、<<<image_1>>>、<<<video_1>>> ● 长度不能超过2500个字符 ● 当multi_shot参数为false时,当前参数不得为空 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图
固定值k3_i2v
是否生成多镜头视频 ● 当前参数为true时,prompt参数无效 ● 当前参数为false时,shot_type参数及multi_prompt参数无效
分镜方式 ● 枚举值:customize ● 当multi_shot参数为true时,当前参数必填
各分镜信息,如提示词、时长等 ● 通过index、prompt、duration参数定义分镜序号及相应提示词和时长,其中: ○ 最多支持6个分镜,最小支持1个分镜 ○ 每个分镜相关内容的最大长度不超过512 ○ 每个分镜的时长不大于当前任务的总时长,不小于1 ○ 所有分镜的时长之和等于当前任务的总时长 ● 用key:value承载,如下:"multi_prompt": [ { "index":int, "prompt": "string", "duration": "5" }, { "index":int, "prompt": "string", "duration": "5" } ] ● 当mult_shot参数为true且shot_type参数为customize时,当前参数不得为空
生成视频时是否同时生成声音 ● 枚举值:on,off ● 仅V2.6及后续版本模型支持当前参数
是否同时生成含水印的结果 ● 通过enabled参数定义,具体array格式如下:"watermark_info": { "enabled": boolean // true 为生成,false 为不生成} ● 暂不支持自定义水印
负向文本提示词 ● 不能超过2500个字符
生成视频的自由度;值越大,模型自由度越小,与用户输入的提示词相关性越强 ● 取值范围:[0, 1] ● kling-v2.x模型不支持当前参数
生成视频的模式 ● 枚举值:std,pro ● 其中std:标准模式(标准),基础模式,性价比高 ● 其中pro:专家模式(高品质),高表现模式,生成视频质量更佳 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图
参考图像 ● 支持传入图片Base64编码或图片URL(确保可访问) ○ 请注意,若您使用base64的方式,请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时,请不要在Base64编码字符串前添加任何前缀,例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。 ○ 示例: ○ 正确的Base64编码参数:iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg== ○ 错误的Base64编码参数(包含data:前缀):data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg== ○ 请仅提供Base64编码的字符串部分,以便系统能够正确处理和解析您的数据。 ● 图片格式支持.jpg / .jpeg / .png ● 图片文件大小不能超过10MB,图片宽高尺寸不小于300px,图片宽高比介于1:2.5 ~ 2.5:1之间 ● image参数与image_tail参数至少二选一,二者不能同时为空 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图
参考图像 - 尾帧控制 ● 支持传入图片Base64编码或图片URL(确保可访问) ○ 请注意,若您使用base64的方式,请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时,请不要在Base64编码字符串前添加任何前缀,例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。 ○ 示例: ○ 正确的Base64编码参数:iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg== ○ 错误的Base64编码参数(包含data:前缀):data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg== ○ 请仅提供Base64编码的字符串部分,以便系统能够正确处理和解析您的数据。 ● 图片格式支持.jpg / .jpeg / .png ● 图片文件大小不能超过10MB,图片宽高尺寸不小于300px ● image参数与image_tail参数至少二选一,二者不能同时为空 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图
参考主体列表 ● 基于主体库中主体的ID配置,用key:value承载,如下 "element_list": [ { "element_id":long }, { "element_id":long }] ● 最多支持3个参考主体 ● 主体分为视频定制主体(简称:视频角色主体)和图片定制主体(简称:多图主体),适用范围不同,请注意区分 ● 不同模型版本、视频模式支持范围不同
生成视频时所引用的音色的列表 ● 一次视频生成任务至多引用2个音色 ● 当voice_list参数不为空且prompt参数中引用音色ID时,视频生成任务按“有指定音色”计量计费 ● voice_id参数值通过音色定制接口返回,也可使用系统预置音色;非对口型API的voice_id ● element_list参数与voice_list参数互斥,不能共存 ● 用key:value承载,如下:"voice_list": [ { "voice_id": "voice_id_1" }, { "voice_id": "voice_id_2" }] ● 不同模型版本、视频模式支持范围不同
模型名称: kling-v3
Response Body
application/json
curl -X POST "https://api.aa.com.cn/api/v1/video/generation" \ -H "Authorization: string" \ -H "Content-Type: application/json" \ -d '{ "_action": "string", "model": "string" }'{
"code": 0,
"data": {
"urls": [
"string"
],
"usage": {
"images": 0,
"seconds": 0,
"input_tokens": 0,
"total_tokens": 0,
"output_tokens": 0
},
"expired": "string",
"task_id": "string",
"task_status": "string"
},
"message": "string",
"request_id": "string"
}