3.2 KiB
3.2 KiB
Kling v3 Omni API 参数基线 V1
同步日期:2026-07-15
适用模型:kling-v3-omni
代码驱动:kling_omni_video
官方基线
- 创建任务:
POST /v1/videos/omni-video - 查询任务:
GET /v1/videos/omni-video/{task_id} - 鉴权:新版 API Key,
Authorization: Bearer <KLING_API_KEY> - 区域域名:
https://api-singapore.klingai.com - 清晰度:
std=720P、pro=1080P、4k=原生 4K - 时长:3-15 秒
- Prompt:最多 2500 字符
- 自定义多镜头:最多 6 段,每段 Prompt 最多 512 字符,各段时长总和必须等于任务总时长
输入限制
- 无参考视频时:
image_list图片数与element_list元素数合计最多 7 个。 - 有参考视频时:图片与元素合计最多 4 个。
- 参考视频最多 1 个;存在参考视频时
sound必须为off。 - 使用首帧/尾帧时,元素最多 3 个。
- 图片支持 JPG/JPEG/PNG,单图不超过 10MB,宽高均不低于 300px,宽高比范围 1:2.5 至 2.5:1。
- 视频支持 MP4/MOV,3-15.5 秒,最大 200MB,24-60fps。
平台生产画幅
- 当前平台不再生产竖屏,新冻结的 S+ Generation Plan 固定为
16:9。 - 1080P视频为1920×1080,原生4K为3840×2160,关键帧基线为2560×1440。
- 已冻结的历史计划和既有素材不原地改写;重新生成时必须冻结新的16:9修订。
视频角色元素
- Kling 元素库的视频角色元素源视频要求单一角色、3-8秒,并建议包含正面与左右轻侧角度。
- 平台默认生成8秒、1080P、16:9的中性角色身份视频;该视频只用于建立角色元素,不承载剧情表演。
- 当前未确认存在可公开调用的“创建视频角色元素”API,因此平台不伪造自动创建能力:用户在 Kling 元素库完成上传后,将真实
element_id导入平台。 - 正式 Omni 请求同时提交
element_list与<<<element_n>>>Prompt 引用;网页端@元素名仅是人工操作语法,不代替 API 绑定。 - 无参考视频时,图片与元素总数不超过7;平台按
可用图片数 = 7 - 已绑定元素数动态收紧图片输入。视频角色元素最多3个。 - S+ 镜头中每个出场角色都必须有质检分不低于90的已审批元素,否则在冻结计划前阻断付费生成。
平台映射
| Provider | mode |
官方价格 |
|---|---|---|
kling-v3-omni-native-audio-720p-video |
std |
$0.112/s |
kling-v3-omni-native-audio-1080p-video |
pro |
$0.14/s |
kling-v3-omni-native-audio-4k-video |
4k |
$0.42/s |
三个 Provider 默认禁用。启用前必须在后台写入新版 KLING_API_KEY,并以单镜头小样验证账号权限、4K 可用性和实际账单。