Kling 3.0

Generate high-quality videos with advanced multi-shot capabilities and element references using Kling 3.0 AI

Overview

Kling 3.0 is an advanced video generation model that supports both single-shot and multi-shot video creation with element references. It offers two generation modes (standard and pro) with different resolution options, and supports sound effects for enhanced video output.

Key Features

Dual Generation Modes: Choose between std (standard resolution) and pro (higher resolution) modes

Multi-Shot Support: Create videos with multiple shots, each with its own prompt and duration

Element References: Reference images in your prompts using @element_name syntax

Sound Effects: Optional sound effects to enhance video output

Flexible Aspect Ratios: Support for 16:9, 9:16, and 1:1 aspect ratios

Configurable Duration: Video duration from 3 to 15 seconds

Resolution Mappings

The resolution depends on both the mode and aspect_ratio parameters:

Standard Mode (std)

Pro Mode (pro)

Aspect Ratio	Resolution
16:9	1280×720
9:16	720×1280
1:1	720×720

Pro mode provides higher resolution output but may take longer to generate and consume more credits.

Single-Shot vs Multi-Shot Mode

Single-Shot Mode (`multi_shots: false`)

Uses the main prompt field for video generation

Supports first and last frame images via image_urls

Sound effects are optional

Multi-Shot Mode (`multi_shots: true`)

Uses multi_prompt array to define multiple shots

Each shot has its own prompt and duration (1-12 seconds)

Only supports first frame image (via image_urls[0])

Sound effects default to enabled

The maximum number of characters per shot is 500

Aspect Ratio Auto-Adaptation

When you provide image_urls (first and/or last frame images), the aspect_ratio parameter becomes optional. The system will automatically adapt the aspect ratio based on the uploaded images, so you don't need to specify it manually.

If you upload reference images, you can omit the aspect_ratio parameter and let the system automatically match the aspect ratio of your images.

Element References

You can reference images or videos in your prompts using the @element_name syntax. Define elements in the kling_elements array:

Image Elements: 2-4 image URLs (JPG/PNG, max 10MB each)

Use descriptive element names and ensure the element name in kling_elements matches the name used in your prompt (without the @ symbol).
A single task can reference a maximum of 3 elements, and each @element will occupy 37 characters.

File Upload Requirements

Before using element references, upload your image files:

1. Upload Files

Use the File Upload API to upload your source images.

File Upload API

Learn how to upload files and get file URLs: File Upload API Quickstart

2. Get File URLs

After upload, you'll receive file URLs that you can use in element_input_urls .

Image formats: JPG, PNG (max 10MB per file, 2-4 files per element)

Ensure file URLs are accessible and not expired

Usage Examples

Single-Shot Video with Element Reference

{
  "model": "kling-3.0",
  "input": {
    "prompt": "In a bright rehearsal room, sunlight streams through the window@element_dog",
    "image_urls": [
      "https://static.aiquickdraw.com/tools/example/1764851002741_i0lEiI8I.png"
    ],
    "sound": true,
    "duration": "5",
    "aspect_ratio": "16:9",
    "mode": "pro",
    "multi_shots": false,
    "kling_elements": [
      {
        "name": "element_dog",
        "description": "dog",
        "element_input_urls": [
          "https://tempfileb.aiquickdraw.com/kieai/market/1770361808044_4RfUUJrI.jpeg",
          "https://tempfileb.aiquickdraw.com/kieai/market/1770361848336_ABQqRHBi.png"
        ]
      }
    ]
  }
}

Multi-Shot Video

{
  "model": "kling-3.0",
  "input": {
    "multi_shots": true,
    "image_urls": [
      "https://static.aiquickdraw.com/tools/example/1764851002741_i0lEiI8I.png"
    ],
    "duration": "5",
    "aspect_ratio": "16:9",
    "mode": "pro",
    "multi_prompt": [
      {
        "prompt": "a happy dog in running@element_cat",
        "duration": 3
      },
      {
        "prompt": "a happy dog play with a cat@element_dog",
        "duration": 3
      }
    ],
    "kling_elements": [
      {
        "name": "element_cat",
        "description": "cat",
        "element_input_urls": [ "https://tempfileb.aiquickdraw.com/kieai/market/1770361808044_4RfUUJrI.jpeg",    "https://tempfileb.aiquickdraw.com/kieai/market/1770361848336_ABQqRHBi.png"
        ]
      },
      {
        "name": "element_dog",
        "description": "dog",
        "element_input_urls": [ "https://tempfileb.aiquickdraw.com/kieai/market/1770361808044_4RfUUJrI.jpeg",    "https://tempfileb.aiquickdraw.com/kieai/market/1770361848336_ABQqRHBi.png"
        ]
      }
    ]
  }
}

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task Details

Learn how to query task status and retrieve generation results: Get Task Details

For production use, we recommend using the callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.

Best Practices

Prompt Writing: Be specific and descriptive in your prompts. Include details about motion, camera angles, and scene composition

Element Usage: Use high-quality reference images/videos for better results. Ensure elements match the style and theme of your video

Duration Planning: For multi-shot videos, plan your shot durations to match the total video duration

Mode Selection: Use pro mode for final output when quality is important, and std mode for faster iterations

Sound Effects: Enable sound effects for more immersive videos, especially for action or dynamic scenes

Market Overview

Common API

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://api.kie.ai/api/v1/jobs/createTask' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "model": "kling-3.0/video", "callBackUrl": "https://your-domain.com/api/callback", "input": { "prompt": "In a bright rehearsal room, sunlight streams through the window @element_dog", "image_urls": [ "https://static.aiquickdraw.com/tools/example/1764851002741_i0lEiI8I.png" ], "sound": true, "duration": "5", "aspect_ratio": "16:9", "mode": "pro", "multi_shots": false, "multi_prompt": [ { "prompt": "a happy dog in running @element_cat", "duration": 3 }, { "prompt": "a happy dog play with a cat @element_dog", "duration": 2 } ], "kling_elements": [ { "name": "element_dog", "description": "dog", "element_input_urls": [ "https://tempfileb.aiquickdraw.com/kieai/market/1770361808044_4RfUUJrI.jpeg", "https://tempfileb.aiquickdraw.com/kieai/market/1770361848336_ABQqRHBi.png" ] }, { "name": "element_cat", "description": "cat", "element_input_urls": [ "https://your-cdn.com/element_image.jpg", "https://your-cdn.com/element_image2.jpg" ] } ] } }'

Overview

Key Features

Resolution Mappings

Single-Shot vs Multi-Shot Mode

Single-Shot Mode (`multi_shots: false`)

Multi-Shot Mode (`multi_shots: true`)

Aspect Ratio Auto-Adaptation

Element References

File Upload Requirements

1. Upload Files

2. Get File URLs

Usage Examples

Single-Shot Video with Element Reference

Multi-Shot Video

Query Task Status

Best Practices

Request

Responses

Kling 3.0

Overview#

Key Features#

Resolution Mappings#

Single-Shot vs Multi-Shot Mode#

Single-Shot Mode (multi_shots: false)#

Multi-Shot Mode (multi_shots: true)#

Aspect Ratio Auto-Adaptation#

Element References#

File Upload Requirements#

1. Upload Files#

2. Get File URLs#

Usage Examples#

Single-Shot Video with Element Reference#

Multi-Shot Video#

Query Task Status#

Best Practices#

Related Resources#

Request

Responses

Overview

Key Features

Resolution Mappings

Single-Shot vs Multi-Shot Mode

Single-Shot Mode (`multi_shots: false`)

Multi-Shot Mode (`multi_shots: true`)

Aspect Ratio Auto-Adaptation

Element References

File Upload Requirements

1. Upload Files

2. Get File URLs

Usage Examples

Single-Shot Video with Element Reference

Multi-Shot Video

Query Task Status

Best Practices

Related Resources