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

# Kling Omni Video

> Use DeerAPI to call the Kling Omni Video endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the Kling Omni Video workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

## Before you start

Use the DeerAPI base URL and pass your API Key in the `Authorization` header:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

## Implementation notes

* Use the OpenAPI playground for the exact request fields accepted by this endpoint.
* Keep API Keys on the server side when you build production applications.
* Log the request ID from failed calls so support can investigate the request.
* Retry `429`, `500`, and `503` responses with exponential backoff.


## OpenAPI

````yaml /api/openapi/video/kling/post-omni-video.openapi.json POST /kling/v1/videos/omni-video
openapi: 3.1.0
info:
  title: DeerAPI Kling Omni Video
  description: Use this field according to the endpoint schema.
  version: 1.1.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /kling/v1/videos/omni-video:
    post:
      summary: DeerAPI Kling Omni Video
      description: Use this field according to the endpoint schema.
      operationId: createKlingOmniVideo
      parameters:
        - name: Content-Type
          in: header
          required: false
          description: ''
          schema:
            type: string
      requestBody:
        description: Use this field according to the endpoint schema.
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
              properties:
                model_name:
                  type: string
                  description: Use this field according to the endpoint schema.
                prompt:
                  type: string
                  description: Use this field according to the endpoint schema.
                  default: Hello
                multi_shot:
                  type: boolean
                  description: Use this field according to the endpoint schema.
                shot_type:
                  type: string
                  description: Use this field according to the endpoint schema.
                multi_prompt:
                  type: array
                  description: Use this field according to the endpoint schema.
                  items:
                    type: object
                    required:
                      - index
                      - prompt
                      - duration
                    properties:
                      index:
                        type: integer
                        description: Use this field according to the endpoint schema.
                      prompt:
                        type: string
                        description: Use this field according to the endpoint schema.
                      duration:
                        type: string
                        description: Use this field according to the endpoint schema.
                sound:
                  type: string
                  description: Use this field according to the endpoint schema.
                image_list:
                  type: array
                  description: Use this field according to the endpoint schema.
                  items:
                    type: object
                    required:
                      - image_url
                    properties:
                      image_url:
                        type: string
                element_list:
                  type: array
                  description: Use this field according to the endpoint schema.
                  items:
                    type: object
                    required:
                      - element_id
                    properties:
                      element_id:
                        type: string
                mode:
                  type: string
                  description: Use this field according to the endpoint schema.
                aspect_ratio:
                  type: string
                  description: Use this field according to the endpoint schema.
                duration:
                  type: string
                  description: Use this field according to the endpoint schema.
                video_list:
                  type: array
                  description: Use this field according to the endpoint schema.
                  items:
                    type: object
                    required:
                      - video_url
                    properties:
                      video_url:
                        type: string
                        description: Use this field according to the endpoint schema.
                      refer_type:
                        type: string
                        description: Use this field according to the endpoint schema.
                      keep_original_sound:
                        type: string
                        description: Use this field according to the endpoint schema.
                watermark_info:
                  type: object
                  description: Use this field according to the endpoint schema.
                  properties:
                    enabled:
                      type: boolean
                      description: Use this field according to the endpoint schema.
                callback_url:
                  type: string
                  description: Use this field according to the endpoint schema.
                external_task_id:
                  type: string
                  description: Use this field according to the endpoint schema.
              default:
                prompt: A cinematic shot of a quiet city street at sunset.
            examples:
              Default:
                summary: DeerAPI Kling Omni Video
                value:
                  model_name: kling-video-o1
                  prompt: >-
                    A cinematic shot of a modern glass workspace at sunrise with
                    smooth camera movement.
                  image_list:
                    - image_url: https://example.com/omni-reference.png
                  mode: pro
                  aspect_ratio: '16:9'
                  duration: '5'
                  callback_url: https://example.com/kling/callback
              Text_To_Video:
                summary: DeerAPI Kling Omni Video
                value:
                  model_name: kling-video-o1
                  prompt: >-
                    A cinematic shot of a modern glass workspace at sunrise with
                    smooth camera movement.
                  mode: pro
                  aspect_ratio: '1:1'
                  duration: '5'
              First_And_Last_Frame:
                summary: DeerAPI Kling Omni Video
                value:
                  model_name: kling-video-o1
                  prompt: >-
                    A cinematic shot of a modern glass workspace at sunrise with
                    smooth camera movement.
                  image_list:
                    - image_url: https://example.com/first-frame.png
                      type: first_frame
                    - image_url: https://example.com/end-frame.png
                      type: end_frame
                  mode: pro
              Video_Reference:
                summary: DeerAPI Kling Omni Video
                value:
                  model_name: kling-video-o1
                  prompt: >-
                    A cinematic shot of a modern glass workspace at sunrise with
                    smooth camera movement.
                  video_list:
                    - video_url: https://example.com/reference-video.mp4
                      refer_type: feature
                      keep_original_sound: 'yes'
                  mode: pro
              Image_Or_Subject_Reference:
                summary: DeerAPI Kling Omni Video
                value:
                  model_name: kling-video-o1
                  prompt: >-
                    A cinematic shot of a modern glass workspace at sunrise with
                    smooth camera movement.
                  image_list:
                    - image_url: https://example.com/image-1.png
                    - image_url: https://example.com/image-2.png
                  element_list:
                    - element_id: '116'
                    - element_id: '155'
                  mode: pro
                  aspect_ratio: '16:9'
                  duration: '5'
              Multi_Shot_Two_Images:
                summary: DeerAPI Kling Omni Video
                value:
                  model_name: kling-v3-omni
                  multi_shot: true
                  shot_type: customize
                  prompt: >-
                    A cinematic video starting with a peaceful park scene,
                    transitioning to a dynamic speeding car.
                  multi_prompt:
                    - index: 1
                      prompt: >-
                        <<<image_1>>> A person sitting on a park bench, sunlight
                        filtering through trees. Simple composition, no
                        dialogue.
                      duration: '2'
                    - index: 2
                      prompt: >-
                        <<<image_2>>> A car speeding down a rainy street,
                        headlights glowing. Dynamic angle, focus on motion.
                      duration: '3'
                  image_list:
                    - image_url: https://example.com/park-bench.png
                    - image_url: https://example.com/rainy-street.png
                  video_list: []
                  mode: pro
                  sound: 'on'
                  aspect_ratio: '16:9'
                  duration: '5'
                  callback_url: https://example.com/kling/callback
                  external_task_id: test_multi_shot_001
              Multi_Shot_Mixed:
                summary: DeerAPI Kling Omni Video
                value:
                  model_name: kling-v3-omni
                  multi_shot: true
                  shot_type: customize
                  prompt: A continuous multi-shot video showing various scenes.
                  multi_prompt:
                    - index: 1
                      prompt: >-
                        Two friends talking under a streetlight at night. Warm
                        glow, casual poses, no dialogue.
                      duration: '2'
                    - index: 2
                      prompt: >-
                        <<<image_1>>> A runner sprinting through a forest,
                        leaves flying. Low-angle shot, focus on movement.
                      duration: '3'
                    - index: 3
                      prompt: >-
                        <<<image_2>>> A woman hugging a cat, smiling. Soft
                        sunlight, cozy home setting, emphasize warmth.
                      duration: '3'
                    - index: 4
                      prompt: >-
                        A door creaking open, shadowy hallway. Dark tones,
                        minimal details, eerie mood.
                      duration: '3'
                    - index: 5
                      prompt: >-
                        A man slipping on a banana peel, shocked expression.
                        Exaggerated pose, bright colors.
                      duration: '3'
                    - index: 6
                      prompt: >-
                        A sunset over mountains, small figure walking away. Wide
                        angle, peaceful atmosphere.
                      duration: '1'
                  image_list:
                    - image_url: https://example.com/forest-runner.png
                    - image_url: https://example.com/woman-cat.png
                  video_list: []
                  sound: 'on'
                  element_list: []
                  mode: pro
                  aspect_ratio: '16:9'
                  duration: '15'
            example:
              model_name: kling-video-o1
              prompt: >-
                A cinematic shot of a modern glass workspace at sunrise with
                smooth camera movement.
              image_list:
                - image_url: https://example.com/omni-reference.png
              mode: pro
              aspect_ratio: '16:9'
              duration: '5'
              callback_url: https://example.com/kling/callback
      responses:
        '200':
          description: Use this field according to the endpoint schema.
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - message
                  - request_id
                  - data
                properties:
                  code:
                    type: integer
                    description: Use this field according to the endpoint schema.
                  message:
                    type: string
                    description: Use this field according to the endpoint schema.
                  request_id:
                    type: string
                    description: Use this field according to the endpoint schema.
                  data:
                    type: object
                    required:
                      - task_id
                      - task_status
                      - task_info
                      - created_at
                      - updated_at
                    properties:
                      task_id:
                        type: string
                        description: Use this field according to the endpoint schema.
                      task_status:
                        type: string
                        description: Use this field according to the endpoint schema.
                      task_info:
                        type: object
                        properties:
                          external_task_id:
                            type: string
                            description: Use this field according to the endpoint schema.
                      created_at:
                        type: integer
                        description: Use this field according to the endpoint schema.
                      updated_at:
                        type: integer
                        description: Use this field according to the endpoint schema.
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |
            curl https://api.deerapi.com/kling/v1/videos/omni-video \
              -H "Content-Type: application/json" \
              -H "Authorization: Bearer $DEERAPI_KEY" \
              -d '{
                "model_name": "kling-video-o1",
                "prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
                "image_list": [
                  {
                    "image_url": "https://example.com/omni-reference.png"
                  }
                ],
                "mode": "pro",
                "aspect_ratio": "16:9",
                "duration": "5",
                "callback_url": "https://example.com/kling/callback"
              }'
        - lang: Python
          label: requests
          source: |
            import os
            import requests

            url = "https://api.deerapi.com/kling/v1/videos/omni-video"
            headers = {
                "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
                "Content-Type": "application/json",
            }
            payload = {
              "model_name": "kling-video-o1",
              "prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
              "image_list": [
                {
                  "image_url": "https://example.com/omni-reference.png"
                }
              ],
              "mode": "pro",
              "aspect_ratio": "16:9",
              "duration": "5",
              "callback_url": "https://example.com/kling/callback"
            }

            response = requests.post(url, headers=headers, json=payload)
            print(response.json())
        - lang: JavaScript
          label: fetch
          source: >
            const response = await
            fetch("https://api.deerapi.com/kling/v1/videos/omni-video", {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "model_name": "kling-video-o1",
                "prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
                "image_list": [
                  {
                    "image_url": "https://example.com/omni-reference.png"
                  }
                ],
                "mode": "pro",
                "aspect_ratio": "16:9",
                "duration": "5",
                "callback_url": "https://example.com/kling/callback"
              }),
            });


            console.log(await response.json());
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````