Skip to main content

Create task

POST /kling/v1/videos/text2video
cURL
200

Request body

string
required
Must be kling-2.5-turbo.
string
required
Positive prompt, up to 2,500 characters.
string
Content to avoid, up to 2,500 characters.
string
default:"std"
std for 720p or pro for 1080p.
string
default:"5"
5 or 10 seconds.
string
default:"16:9"
16:9, 9:16, or 1:1.
object
Set enabled to request an additional watermarked result.

Query task by ID

GET /kling/v1/videos/text2video/{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
Text-to-video task ID returned by the create endpoint.
cURL

Task result

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.
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.
This page uses Kling Legacy paths. Kling 2.5 Turbo does not support audio, specified voices, multi-shot, motion brush, camera control, or cfg_scale.