model_name in the request body.
- Text to Video
- Image to Video
Create task
POST /kling/v2/text-to-video/kling-3.0-turbocURL
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 formatShot 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.