Image-to-video

The request can include a first frame, an optional last frame, and generation parameters.

POST/kling/v1/videos/image2video

Create a Kling native image-to-video task using a first-frame image and an optional last frame.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization header.

In: header

Request Body

application/json

Kling native image-to-video request.

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Kling native model ID, such as kling-v2-5-turbo or kling-v2-6. Available models are determined by the model list returned for the current API key.

Length1 <= length

prompt*string

Positive prompt, up to 2,500 characters.

Lengthlength <= 2500

negative_prompt?string

Negative prompt.

Lengthlength <= 2500

init_image*string

First-frame image URL. Required for image-to-video.

Length1 <= length

image_tail?string

Optional last-frame image URL. When using a last frame, set mode=pro. For kling-v2-6, providing this field in std mode returns 1201.

mode?string

Generation mode. Must be pro when image_tail is used.

Value in

"std"
"pro"

aspect_ratio?string

Output aspect ratio.

Default"16:9"

Value in

"16:9"
"9:16"
"1:1"

duration_string?string

Video duration in seconds.

Value in

"5"
"10"

cfg_scale?number

Prompt adherence strength.

Range0 <= value <= 1

sound?string

Whether to generate audio. Supported only by V2.6 and later models.

Value in

"on"
"off"

voice_list?array<>

List of referenced voices.

Itemsitems <= 2

callback?string

Task status callback URL.

Formaturi

params?string

Callback passthrough parameter.

Response Body

`application/json`

curl -X POST "https://example.com/kling/v1/videos/image2video" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Preserve the subject style and have the character slowly walk toward the camera",    "negative_prompt": "blurry, low resolution",    "init_image": "https://example.com/input-image.jpg",    "image_tail": "https://example.com/end-frame.jpg",    "mode": "pro",    "aspect_ratio": "16:9",    "duration_string": "10",    "cfg_scale": 0.6,    "sound": "on",    "callback": "https://example.com/kling/callback",    "params": "user_id_123"  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "task_id": "task_id_here",
    "task_status": "submitted",
    "created_at": 1640995200000,
    "updated_at": 1640995200000
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`