# 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 可用性和实际账单。

## 官方资料

- [Kling v3 Omni API](https://kling.ai/document-api/api/video/3-0-omni/video-omni)
- [Authentication](https://kling.ai/document-api/api/get-started/authentication)
- [Billing Method](https://kling.ai/document-api/productBilling/billingMethod)
- [Kling Video 3 Omni Guide](https://kling.ai/quickstart/klingai-video-3-omni-model-user-guide)
- [Kling Element Library Guide](https://kling.ai/quickstart/klingai-element-library-3-user-guide)
- [Kling Video 3 Model Guide](https://kling.ai/quickstart/klingai-video-3-model-user-guide)