Kling image-to-video

Creates an image-to-video generation task using Kling AI models. Provide a reference image along with a text prompt to generate a video.

How To Use

Provide at least one of image or image_tail, along with an optional text prompt. The task is asynchronous - use the retrieve endpoint to check status.

Note: image_tail (end frame) requires pro mode. Using image_tail with std mode will return an error (e.g. model/mode(kling-v2-6/std) is not supported with image_tail in standard mode).

Supported Models

kling-v1: Base model

kling-v1-6: Version 1.6

kling-v2-master: V2 Master

kling-v2-1-master: V2.1 Master

kling-v2-5-turbo: V2.5 Turbo

kling-v2-6: V2.6 - supports sound generation and voice list

kling-v3: V3 - latest model, supports sound generation and voice list

Mutual Exclusivity

These three groups are mutually exclusive — only one can be used at a time:

image + image_tail (start/end frame interpolation)

dynamic_masks / static_mask (motion brush)

camera_control (camera movement)

Voice List

Max 2 voices per task. Reference in prompt with <<<voice_1>>>, <<<voice_2>>> syntax

V2.6+ models only. When used, sound must be on

Billing

Per-call pricing. Multipliers: mode: pro = 3.5x, duration: 10 = 2x. Voice-specified tasks billed separately.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Basic image-to-videoStart + end frame interpolation (pro mode required)Most parameters

{
    "model_name": "kling-v3",
    "prompt": "The girl gently smiles and looks at the camera",
    "image": "https://example.com/image.png",
    "duration": "5",
    "mode": "std"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Task created successfully

Bodyapplication/json

Example

{
    "id": "task_QhsRYpMj41sFhMaK875USMC4wAjftfZr",
    "task_id": "task_QhsRYpMj41sFhMaK875USMC4wAjftfZr",
    "object": "video",
    "model": "kling-v2-6",
    "status": "",
    "progress": 0,
    "created_at": 1772095783
}

🟠400Bad Request

🟠401Unauthorized

🔴500Internal Server Error

How To Use#

Supported Models#

Mutual Exclusivity#

Voice List#

Billing#