模型参数
- 模型ID:
kling-video-v3 - 模型价格:你可以在模型详情页查看最新价格信息
- 调用入口:
https://geekai.co/api/v1/videos/generations - 模型参数:参考视频 API 手册
- API认证:获取 API KEY
aspect_ratio 参数支持以下取值:
1:116:99:16
quality 参数替代官方的 mode 参数来控制生成视频的分辨率,quality 的取值范围是 std(对应 720p)、 pro(对应 1080p)和 4k(v3开始支持),默认值是 std,不同质量的视频生成时间和成本不同。
支持通过 with_audio 参数来控制是否生成带有音频的视频,with_audio 的取值范围是 true(对应官方 audio 值为 native) 和 false(对应官方 audio 值为 off),默认值是 false,生成带有音频的视频会增加生成时间和成本。
支持通过 watermark 参数替代官方的 watermark_info 参数来控制生成视频是否带有水印,watermark 的取值范围是 true 和 false,默认值是 false。
可灵视频 3.0 的 duration 参数支持生成 3-15s 的视频,默认值是 5s,生成更长时长的视频会增加生成时间和成本。
支持通过 extra_body 传递额外参数来设置视频分镜、参考主体和音色等信息:
multi_shot: 控制是否开启分镜,取值范围是true和false,默认值是false,开启多镜头模式后,可以通过shot_type参数来指定分镜类型。shot_type: 指定分镜类型,取值范围是customize和intelligence,分别代表自定义分镜和智能分镜, 当multi_shot为true时本参数必填。multi_prompt: 描述每个分镜的信息,如提示词、时长等,当multi_shot为true且shot_type为customize时,本参数必填。element_list: 参考主体列表,基于主体库中主体的 ID 配置,最多支持3个。
模型价格
可灵视频 3.0 的价格按照生成视频的质量、时长和是否带有音频来计算,以下是价格表:
使用极客智坊提供的低价代理渠道调用时,不同参数对应价格按照价格表x对应的折扣值即可:以高可用速度优先渠道为例,折扣值是
0.8,那么生成 5 秒无声标准视频价格是 0.6 x 5 x 0.8 = 2.4 元,其他参数依次类推。
文生视频
通过文字描述来生成对应视频:async 参数用于控制是否异步生成视频,默认为 false,表示创建视频接口会同步等待视频生成完毕并返回。如果设置为 true,则会异步生成视频并返回任务ID:
task_status 值判断视频是否已经生成完成,这个状态值包括四种情况:
pending:任务已创建,等待处理running:任务正在处理succeed:任务成功完成,可以获取结果failed:任务失败,可能是由于内容违规或其他错误
succeed,你就可以获取到生成的视频 URL:
图生视频
首帧 通过image 传入单图即可实现基于首帧生成视频:
image + image_tail 传入首尾两张图即可实现基于首尾帧生成视频:
- 支持 JPG、PNG、WEBP 格式,单张图片大小不超过 10MB;
- 支持 URL 和 Base64 两种方式传入图片,URL 方式需要保证图片可以被公网访问;
- 图片宽高尺寸不小于 300px,图片宽高比介于 1:2.5 ~ 2.5:1 之间;
- image 参数与 image_tail 参数至少二选一,二者不能同时为空。
动作控制
可灵视频动作控制是一项基于视频动作捕捉与迁移的技术,主要核心功能包括动作克隆、精准动作迁移、肢体与表情全面掌控。它能提取参考视频中的人物动作、手势、口型与表情特征,驱动静态图像角色生成动态视频。 下面是可灵视频 3.0 动作控制生成视频的一个示例:action 字段值为 motion-control,目前仅 2.6 和 3.0 版本支持该功能,其他模型设置该参数会报错。
自定义主体
可灵视频 3.0 支持通过自定义主体来生成视频,自定义主体可以实现基于参考图+参考视频+自定义音色生成视频。 你可以通过独立的主体管理API生成自定义主体进行引用,也可以在创建视频任务时一起提交主体素材,对于一次性任务这样更方便(自定义音色暂不支持自动转化,仍然需要通过独立的自定义音色接口获取音色ID):task_id 调用自定义主体轮询接口获取主体生成结果:
task_status 值为 succeed, 表示生成成功,对应的生成结果数据结构如下:
task_result.elements[0].element_id 即为本次生成的主体 ID,你可以将其传入视频生成接口实现基于自定义主体创建视频:
reference_type 参数需要设置为 video_refer 同时通过 videos 字段传入参考视频 URL。
自定义音色
你可以通过自定义音色接口创建自定义音色用于在自定义主体时引用:task_id 调用自定义音色轮询接口获取音色生成结果:
视频分镜
可灵视频 3.0 支持通过extra_body 参数来控制分镜能力,以下是一个多镜头图生视频示例:
