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}

Request headers

string
required
Bearer authentication in the form Bearer YOUR_API_KEY.
string
default:"application/json"
required
Data exchange format. Use application/json.

Path parameters

string
required
The task ID returned by the create endpoint.
cURL
data.task_status is submitted, processing, succeed, or failed. When the task succeeds, data.task_result.videos[] contains the temporary result url and actual duration.

Response fields

integer
0 indicates that the query was accepted.
string
Error information; empty for a successful query.
string
Queried task ID.
string
submitted, processing, succeed, or failed.
string
Failure details when the task fails.
object[]
Generated videos, returned after success.
string
Temporary generated-video URL.
string
Actual duration in seconds.
integer
Creation Unix timestamp in milliseconds.
integer
Last update Unix timestamp in milliseconds.
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.