Generate videos using 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 or videos 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

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

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.

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)

Video Elements: 1 video URL (MP4/MOV, max 50MB)

File Upload Requirements

Before using element references, upload your image or video files:

1. Upload Files

Use the File Upload API to upload your source images or videos.

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 or element_input_video_urls.

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_video_urls": [
          "https://your-cdn.com/element_video.mp4"
        ]
      },
      {
        "name": "element_dog",
        "description": "dog",
        "element_input_urls": [
          "https://tempfileb.aiquickdraw.com/kieai/market/1770361808044_4RfUUJrI.jpeg"
        ]
      }
    ]
  }
}

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

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

Explore all available models

Check credits and account usage

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": 3 } ], "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_video_urls": [ "https://your-cdn.com/element_video.mp4" ] } ] } }'

Generate videos using 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

🏪 Market Overview

⚙️ Common API

Request

Responses

Generate videos using 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#

🏪 Market Overview#

⚙️ Common API#

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

🏪 Market Overview

⚙️ Common API