Skip to main content
Kling 3.0 Turbo uses Kling’s upgraded model-specific API. The model name is part of the endpoint path; do not send model_name in the request body.

Create task

POST /kling/v2/text-to-video/kling-3.0-turbo
cURL
200

Request headers

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

Request body

string
required
Positive and negative text descriptions. The maximum length is 3,072 characters; prompts under 2,500 characters are recommended.
object
Output resolution, aspect ratio, and duration.
string
default:"720p"
Output resolution. Supported values: 720p, 1080p.
string
default:"16:9"
Output aspect ratio. Supported values: 16:9, 9:16, 1:1.
integer
default:5
Video duration in seconds. Supported integer values: 3 through 15.
object
General generation options.
object
Platform watermark configuration.
boolean
default:false
Set to true to generate an additional watermarked result.

Multi-shot prompt format

A prompt can define one to six shots with the format Shot n, m, words;. n is the shot number, m is the shot duration in seconds, and words is the shot description. Each shot must last at least one second, the durations must add up to settings.duration, and each shot description can contain up to 512 characters.

Create response

integer
Error code. 0 indicates that the request was accepted.
string
Error or status message.
string
System-generated request ID for tracing and troubleshooting.
object
Created asynchronous task.
string
System-generated task ID.
string
Task status: submitted, processing, succeeded, or failed.
integer
Creation time as a Unix timestamp in milliseconds.
integer
Last update time as a Unix timestamp in milliseconds.
string
External task ID when present.

Query task by ID

GET /kling/v2/tasks?task_ids=TASK_ID
cURL
string
required
One or more system-generated task IDs. Separate multiple IDs with commas.
200

Task result fields

object[]
Matched asynchronous tasks.
string
System-generated task ID.
string
submitted, processing, succeeded, or failed.
string
Task status details or the failure reason.
integer
Creation Unix timestamp in milliseconds.
integer
Last update Unix timestamp in milliseconds.
string
External task ID when present.
object[]
Generated outputs.
string
For this model, video.
string
Generated video ID.
string
Temporary generated video URL.
string
Watermarked video URL when requested.
string
Generated video duration in seconds.
object[]
Billing deductions for the task.
string
cash for balance deduction or unit for resource-package deduction.
string
Deducted balance or resource-package units.
string
Resource-package type; video for this model.
string
List-price deduction when charge_type is cash.
Generated image and video URLs are cleared after 30 days. Download and store successful results promptly.