Image to Video

Generate videos from images using the Kling v2.5 Turbo model.

POST /vendors/klingai/v1/kling-v2.5-turbo/image-to-video/generation

Image to Video Generation

cURL

curl --request POST \
  --url https://api.mulerun.com/vendors/klingai/v1/kling-v2.5-turbo/image-to-video/generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mode": "pro",
  "duration": 5,
  "image": "https://example.com/image.jpg",
  "prompt": "A bird is flying over the lake"
}
'

202

{
  "task_info": {
    "id": "8e1e315e-b50d-4334-a231-be7d19a372f4",
    "status": "pending",
    "created_at": "2025-09-21T00:00:00.000Z",
    "updated_at": "2025-09-21T00:00:00.000Z"
  }
}

This API supports Kling v2.5 Turbo video generation model. Please refer to Kling’s official documentation for more details.

Overview

Generate videos from images using the Kling v2.5 Turbo model with faster generation speed and advanced features.

Key Features

• Fast image-to-video generation
• Standard and Professional quality modes
• 5s or 10s duration
• End frame control (image_tail)
• Motion brush support (static_mask, dynamic_masks)

Image Requirements

Property	Requirement
Formats	JPEG, JPG, PNG
Dimensions	Min 300px for both width and height
Aspect Ratio	Between 1:2.5 and 2.5:1
File Size	Max 10MB
Input	Public URL or Base64 encoded data

Example Requests

Basic Image-to-Video

{
  "image": "https://example.com/landscape.jpg",
  "prompt": "Camera slowly pans across the landscape",
  "mode": "std",
  "duration": 5
}

With End Frame Control

{
  "image": "https://example.com/start.jpg",
  "image_tail": "https://example.com/end.jpg",
  "prompt": "Smooth transition between frames",
  "mode": "pro",
  "duration": 5
}

With Dynamic Masks

{
  "image": "https://example.com/scene.jpg",
  "prompt": "Object moves along the path",
  "static_mask": "https://example.com/static_mask.png",
  "dynamic_masks": [
    {
      "mask": "https://example.com/dynamic_mask.png",
      "trajectories": [
        {"x": 100, "y": 200},
        {"x": 300, "y": 400}
      ]
    }
  ],
  "mode": "std",
  "duration": 5
}

Parameters

image_tail

• Optional: Yes
• Description: End frame image for video interpolation
• Note: Cannot be used with dynamic_masks/static_mask

dynamic_masks

• Optional: Yes
• Description: Up to 6 groups of mask and trajectory configurations
• Note: Cannot be used with image_tail

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

image · string · required

Reference Image. Support inputting image Base64 encoding or image URL.

Important: When using Base64 encoding, do not add any prefixes such as data:image/png;base64,. Provide only the Base64-encoded string itself.

• Supported image formats: .jpg, .jpeg, .png
• Image file size cannot exceed 10MB
• Width and height dimensions must not be less than 300px
• Aspect ratio should be between 1:2.5 ~ 2.5:1

image_tail · string | null

Reference Image - End frame control. Support inputting image Base64 encoding or image URL.

• At least one parameter should be filled in between image and image_tail
• image+image_tail and dynamic_masks/static_mask cannot be used at the same time

prompt · string

Positive text prompt. Cannot exceed 2500 characters.

Maximum string length: 2500

negative_prompt · string

Negative text prompt. Cannot exceed 2500 characters.

Maximum string length: 2500

mode · enum<string> · default: std

Video generation mode

std: Standard Mode, which is cost-effective. pro: Professional Mode, generates videos use longer duration but higher quality video output.

Available options: std, pro

static_mask · string | null

Static Brush Application Area (Mask image created by users using the motion brush).

• Support inputting image Base64 encoding or image URL
• The aspect ratio of the mask image must match the input image

dynamic_masks · object[] | null

Dynamic Brush Configuration List. Multiple configurations can be set up (up to 6 groups).

Maximum array length: 6

Show child attributes

duration · enum<integer> · default: 5

Video Length in seconds

Available options: 5, 10

Response

202 - application/json

Accepted - Task created successfully

task_info · object

Show child attributes