Files
ai/docs/work-sync/KLING_V3_OMNI_API_UPDATE_V1.md

3.2 KiB
Raw Permalink Blame History

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 KeyAuthorization: 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/MOV3-15.5 秒,最大 200MB24-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 可用性和实际账单。

官方资料