feat: expand novel IP and production workflows

docs/work-sync/KLING_V3_OMNI_API_UPDATE_V1.md

@@ -0,0 +1,59 @@
+# 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)