> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapon.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Omni 视频（Legacy）

> 旧版 O1 / Kling 3.0 Omni 多模态视频与分镜

本页对应[官方 Legacy Omni 视频](https://kling.ai/document-api/api/video/3-0-omni/video-omni/legacy)。新版 `contents/settings/options` 请求请使用 [API 2.0](/kling/api2-kling3)。

| 参数                 | 类型      | 说明                                                                    |
| ------------------ | ------- | --------------------------------------------------------------------- |
| `model_name`       | string  | `kling-video-o1`（默认）或 `kling-v3-omni`                                 |
| `prompt`           | string  | 单镜头、智能分镜必填；自定义分镜可省略                                                   |
| `multi_shot`       | boolean | 默认false；3.0 Omni支持多镜头                                                 |
| `shot_type`        | string  | 多镜头时必填，`customize/intelligence`                                       |
| `multi_prompt`     | array   | 自定义分镜 `[{index,prompt,duration}]`，序号从1连续递增、最多6段，每段至少1秒，总时长须等于duration |
| `image_list`       | array   | `[{image_url,type}]`；首尾帧type为 `first_frame/end_frame`                 |
| `element_list`     | array   | `[{element_id}]`，保留主体ID精度                                             |
| `video_list`       | array   | `[{video_url,refer_type,keep_original_sound}]`；feature为参考、base为编辑     |
| `sound`            | string  | `on/off`，原生音频支持范围按模型                                                  |
| `mode`             | string  | 默认pro；3.0 Omni支持std/pro/4k，O1为std/pro                                 |
| `aspect_ratio`     | string  | 16:9、9:16、1:1；是否需要由输入组合决定                                             |
| `duration`         | string  | 默认5；3.0 Omni为3～15秒，O1为3～10秒，具体组合以官网为准                                 |
| `watermark_info`   | object  | `{"enabled":true}` 同时生成水印结果                                           |
| `callback_url`     | string  | 公网HTTPS回调地址                                                           |
| `external_task_id` | string  | 业务ID，推荐UUID避免上游账号内冲突                                                  |

图片、主体和视频可用 `<<<image_1>>>`、`<<<element_1>>>`、`<<<video_1>>>` 在旧版提示词中引用。参考数量与组合上限因模型和素材类型不同而变化，不把O1的限制套用到3.0 Omni。

`refer_type=base` 的视频编辑不支持首尾帧和多镜头，生成时长与输入视频一致。视频参考及原生音频组合限制请遵循对应官方模型页。

## 自定义分镜示例

```bash theme={null}
curl -X POST "https://models.kapon.cloud/kling/v1/videos/omni-video" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name":"kling-v3-omni",
    "multi_shot":true,
    "shot_type":"customize",
    "multi_prompt":[
      {"index":1,"prompt":"A train enters a snowy valley","duration":"3"},
      {"index":2,"prompt":"The camera follows the train","duration":"3"}
    ],
    "duration":"6",
    "mode":"pro",
    "aspect_ratio":"16:9"
  }'
```

创建返回 `data.task_id` 和平台 `platform_id`。使用 `/kling/v1/videos/omni-video/{id}` 查询；成功状态为 `succeed`，视频结果位于 `task_result.videos`。完整说明见 [Legacy 任务查询](/kling/task-query)。


## OpenAPI

````yaml POST /kling/v1/videos/omni-video
openapi: 3.0.3
info:
  title: Kling API
  version: '2026-09-07'
  description: API 2.0 与 Legacy 分开定义；请求使用 Kapon Token。
servers:
  - url: https://models.kapon.cloud
security:
  - BearerAuth: []
paths:
  /kling/v1/videos/omni-video:
    post:
      tags:
        - Kling
      summary: Omni video
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/kling.OfficialOmniVideoRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/kling.OfficialResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    kling.OfficialOmniVideoRequest:
      type: object
      properties:
        aspect_ratio:
          description: 画面纵横比
          type: string
        callback_url:
          description: 回调通知地址
          type: string
        duration:
          description: 视频时长
          type: string
        element_list:
          description: 主体参考列表
          type: array
          items:
            $ref: '#/components/schemas/kling.OmniElementItem'
        external_task_id:
          description: 自定义任务ID
          type: string
        image_list:
          description: 参考图列表
          type: array
          items:
            $ref: '#/components/schemas/kling.OmniImageItem'
        mode:
          description: 生成模式：std, pro
          type: string
        model_name:
          description: 模型名称，默认kling-video-o1
          type: string
        multi_prompt:
          type: array
          items:
            $ref: '#/components/schemas/kling.OfficialVideoShot'
        multi_shot:
          type: boolean
        prompt:
          description: 正向文本提示词，必须
          type: string
        shot_type:
          type: string
        sound:
          description: 是否生成声音：on/off
          type: string
        video_list:
          description: 参考视频列表
          type: array
          items:
            $ref: '#/components/schemas/kling.OmniVideoItem'
        watermark_info:
          description: 水印信息
          allOf:
            - $ref: '#/components/schemas/kling.OfficialWatermarkInfo'
    kling.OfficialResponse:
      type: object
      properties:
        code:
          description: 错误码
          type: integer
        data:
          description: 单个任务数据
          allOf:
            - $ref: '#/components/schemas/kling.OfficialTaskData'
        data_list:
          description: 任务列表数据（用于列表查询）
          type: array
          items:
            $ref: '#/components/schemas/kling.OfficialTaskData'
        message:
          description: 错误信息
          type: string
        request_id:
          description: 请求ID
          type: string
    kling.OmniElementItem:
      type: object
      properties:
        element_id:
          description: 主体ID，保留64位整数精度
          type: integer
          format: int64
    kling.OmniImageItem:
      type: object
      properties:
        image:
          description: 图片URL或Base64编码（omni-image 官方字段）
          type: string
        image_url:
          description: 图片URL或Base64编码
          type: string
        type:
          description: first_frame / end_frame
          type: string
    kling.OfficialVideoShot:
      type: object
      properties:
        duration:
          type: string
        index:
          type: integer
        prompt:
          type: string
    kling.OmniVideoItem:
      type: object
      properties:
        keep_original_sound:
          description: yes/no
          type: string
        refer_type:
          description: feature/base
          type: string
        video_url:
          description: 视频URL
          type: string
    kling.OfficialWatermarkInfo:
      type: object
      properties:
        enabled:
          description: 是否生成含水印结果
          type: boolean
    kling.OfficialTaskData:
      type: object
      properties:
        created_at:
          description: 任务创建时间，Unix时间戳、单位ms
          type: integer
        final_balance_deduction:
          type: object
        final_unit_deduction:
          description: 实际扣减积分
          type: string
        platform_id:
          description: One-Hub 平台统一追踪 ID（video_<ULID>）
          type: string
        task_id:
          description: 任务ID — 上游原始任务 ID
          type: string
        task_info:
          description: 任务创建时的参数信息
          allOf:
            - $ref: '#/components/schemas/kling.OfficialTaskInfo'
        task_result:
          description: 任务结果
          allOf:
            - $ref: '#/components/schemas/kling.OfficialTaskResult'
        task_status:
          description: 任务状态
          type: string
        task_status_msg:
          description: 任务状态信息
          type: string
        updated_at:
          description: 任务更新时间，Unix时间戳、单位ms
          type: integer
        watermark_info:
          description: 水印信息
          allOf:
            - $ref: '#/components/schemas/kling.OfficialWatermarkInfo'
    kling.OfficialTaskInfo:
      type: object
      properties:
        external_task_id:
          description: 客户自定义任务ID
          type: string
    kling.OfficialTaskResult:
      type: object
      properties:
        videos:
          type: array
          items:
            $ref: '#/components/schemas/kling.OfficialVideoResult'
    kling.OfficialVideoResult:
      type: object
      properties:
        duration:
          description: 视频总时长，单位s
          type: string
        id:
          description: 生成的视频ID
          type: string
        url:
          description: 生成视频的URL
          type: string
        watermark_url:
          description: 含水印视频下载URL
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````