---
title: "Kling 3"
method: POST
path: "/v2/generation/kling-3"
tags: ["Kling Video"]
---

# Kling 3

`POST /v2/generation/kling-3`

Video Generation using Kling 3.0, 720p, 1080p and 4K

## Query parameters

- `webhookUrl` string — Your Webhook URL, if specified, the result of the generation will be POSTed to this URL.
- `demoMode` 'failure' | 'success' — This parameter is used when the api key mode is 'development', default value is 'success'. when set to 'failure', the dummy generation will be 'failed' after a few seconds, if set to 'success', the dummy generation will be 'completed' after a few seconds.

## Request body

- object
  - `enableAudio` boolean, required
  - `elements` union[]
    - union
      - object
        - `type` 'image', required
        - `tag` 'character' | 'animal' | 'prop' | 'costume' | 'scene' | 'effect' | 'others', required
        - `images` string[], required — An array of image names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.
        - `voice` string, required — An array of video names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.A video file of the character's voice for cloning the voice (optional)
        - `name` string, required
      - object — Video element, can only be of type character
        - `type` 'video', required
        - `tag` 'character' | 'animal' | 'prop' | 'costume' | 'scene' | 'effect' | 'others', required
        - `video` string, required
        - `voice` string — An array of video names or download URLs - if you don't have a download URL, you can upload the file and get the file name from the /upload endpoint.A video file of the character's voice for cloning the voice (optional)
        - `name` string, required
  - `aspectRatio` '1:1' | '16:9' | '9:16' — If no image selected, aspect ratio is required
  - `duration` '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15', required
  - `prompt` string
  - `multiShot` 'auto' | 'manual', required
  - `shots` object[]
    - `text` string, required
    - `duration` '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15', required
  - `startImage` string — Optional, if not passed, it'll be Text to Video - Required when multi shot is set to 'manual'
  - `endImage` string — Optional, if passed, start image must be passed too
  - `quality` '720' | '1080' | '4K', required

## Response `200`

Response for status 200

- object
  - `genId` string, required

## Other responses

- `400` — Response for status 400
- `401` — Response for status 401
- `403` — Response for status 403
- `500` — Response for status 500

## Changes

- **2026-09-08** `2e066072b0aa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/radinai/apis/api/changes/v2/generation/kling-3/post.md)

---

[API](https://skmtc.dev/radinai/apis/api.md) · [All operations](https://skmtc.dev/radinai/apis/api/llms.txt) · [OpenAPI document](https://skmtc.dev/radinai/apis/api/revisions/4555b7f121b7?raw)