典名词元典名词元首页
API 文档
AI 模型接口视频可灵

3.0 Omni生视频

POST
/api/v1/video/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

duration?string

生成视频时长,单位s ● 枚举值:3,4,5,6,7,8,9,10,11,12,13,14,15,其中: ○ 使用视频编辑功能("refer_type":"base")时,输出结果与传入视频时长相同,此时当前参数无效;此时,按输入视频时长四舍五入取整计量计费 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图

prompt?string

文本提示词,可包含正向描述和负向描述 ● 可将提示词模板化来满足不同的视频生成需求 Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力 ○ 通过<<<>>>的格式来指定某个主体、图片、视频,如:<<<element_1>>>、<<<image_1>>>、<<<video_1>>> ● 长度不能超过2500个字符 ● 当multi_shot参数为false时,当前参数不得为空 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图

_action*string

固定值k3-omni_i2v

multi_shot?boolean

是否生成多镜头视频 ● 当前参数为true时,prompt参数无效 ● 当前参数为false时,shot_type参数及multi_prompt参数无效

shot_type?string

分镜方式 ● 枚举值:customize ● 当multi_shot参数为true时,当前参数必填

multi_prompt?array<string>

各分镜信息,如提示词、时长等 ● 通过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时,当前参数不得为空

image_list?array<string>

参考图列表 ● 包括主体、场景、风格等参考图片,也可作为首帧或尾帧生成视频;当作为首帧或尾帧生成视频时: ○ 通过type参数来定义图片是否为首尾帧:first_frame为首帧,end_frame为尾帧 ○ 暂时不支持仅尾帧,即有尾帧图时必须有首帧图 ○ 首帧或首尾帧生视频时,不能使用视频编辑功能 ● 用key:value承载,如下:"image_list":[ { "image_url":"image_url", "type":"first_frame" }, { "image_url":"image_url", "type":"end_frame" }] ● 支持传入图片Base64编码或图片URL(确保可访问) ● 图片格式支持.jpg / .jpeg / .png ● 图片文件大小不能超过10MB,图片宽高尺寸不小于300px,图片宽高比要在1:2.5 ~ 2.5:1之间 ● 有参考视频时,参考图片数量不得超过4;无参考视频时,参考图片数量不得超过7 ● 使用O1模型时,数组中超过2张图片时,不支持设置首尾帧 ● image_url参数值不得为空

element_list?array<string>

参考主体列表 ● 基于主体库中主体的ID配置,用key:value承载,如下:"element_list":[ { "element_id":long }, { "element_id":long }] ● 参考主体数量与有无参考视频、参考图片数量有关,其中: ○ 如果使用首帧生视频或首尾帧生视频时,最多支持3个主体; ○ 有参考视频时,参考图片数量和参考主体数量之和不得超过4,且不支持使用视频角色主体; ○ 无参考视频时,参考图片数量和参考主体数量之和不得超过7; ● 主体分为视频定制主体(简称:视频角色主体)和图片定制主体(简称:多图主体),适用范围不同,请注意区分 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图

video_list?array<string>

参考视频,通过URL方式获取 ● 可作为特征参考视频,也可作为待编辑视频,默认为待编辑视频;可选择性保留视频原声 ○ 通过refer_type参数区分参考视频类型:feature为特征参考视频,base为待编辑视频 ○ 参考视频为待编辑视频时,不能定义视频首尾帧 ○ 通过keep_original_sound参数选择是否保留视频原声,yes为保留,no为不保留;当前参数对特征参考视频(feature)也生效 ● 有参考视频时,sound参数值只能为off ● 用key:value承载,如下:"video_list":[ { "video_url":"video_url", "refer_type":"base", "keep_original_sound":"yes" }] ● 视频格式仅支持MP4/MOV ● 视频时长不少于3秒,上限与模型版本有关,详见能力地图 ● 视频宽高尺寸需介于720px(含)和2160px(含)之间 ● 视频帧率基于24fps~60fps,生成视频时会输出为24fps ● 至多仅支持上传1段视频,视频大小不超过200MB ● video_url参数值不得为空 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图

sound?string

生成视频时是否同时生成声音 ● 枚举值:on,off ● 仅V2.6及后续版本模型支持当前参数

watermark_info?array<string>

是否同时生成含水印的结果 ● 通过enabled参数定义,具体array格式如下:"watermark_info": { "enabled": boolean // true 为生成,false 为不生成} ● 暂不支持自定义水印

mode?string

生成视频的模式 ● 枚举值:std,pro ● 其中std:标准模式(标准),基础模式,性价比高 ● 其中pro:专家模式(高品质),高表现模式,生成视频质量更佳 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图

aspect_ratio?string

生成视频的画面纵横比(宽:高) ● 枚举值:16:9, 9:16, 1:1 ● 未使用首帧参考或视频编辑功能时,当前参数必填

model*string

模型名称: kling-v3-omni

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"
}