Skip to main content
This page consolidates Kling 2.1 image-to-video creation and task queries. Each tab keeps its request, response, and fields together.

Create task

POST /kling/v1/videos/image2video
cURL

Request headers

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

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.

Create response

200
string
AnyFast task ID.
string
Task ID, equal to id.
string
Object type, always video.
string
Public model ID used for the task.
string
Initial status, always queued.
integer
Initial progress, always 0.
integer
Creation time as a Unix timestamp in seconds.

Query task by ID

GET /kling/v1/videos/image2video/{task_id}
cURL

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 image-to-video task ID returned by the create endpoint.

Task result

200
integer
0 indicates that the query succeeded.
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.
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.