Skip to main content

Image to video

Create task

POST /kling/v1/videos/image2video
cURL
200

Request body

string
required
Must be kling-2.1.
string
required
Start-frame URL or raw Base64.
string
Optional end frame. Start-and-end-frame generation requires 1080p pro mode.
string
Positive prompt, up to 2,500 characters.
string
Negative prompt, up to 2,500 characters.
string
default:"std"
std for 720p or pro for 1080p.
string
default:"5"
5 or 10 seconds.
object
Set enabled to request an additional watermarked result.

Image requirements

Use a public URL or raw Base64 without a data URI prefix. JPG, JPEG, and PNG are supported. Files must be no larger than 10 MB, both sides at least 300 px, and the aspect ratio between 1:2.5 and 2.5:1.

Query task by ID

GET /kling/v1/videos/image2video/{task_id}
cURL
string
required
The task ID returned by the create endpoint.
Task status is submitted, processing, succeed, or failed. Successful output is in data.task_result.videos; failure details are in data.task_status_msg. Result items contain id, url, watermark_url, and duration.
200
Generated result URLs are removed after 30 days. Save the files promptly.
Kling 2.1 does not provide text-to-video. It also does not support audio, specified voices, multi-shot, motion brush, camera control, or cfg_scale.