Skip to main content
POST
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the response result through the unified Query Task Status endpoint.

Available Models

  • kling-3.0-turbo/standard - 720p Turbo video generation
  • kling-3.0-turbo/pro - 1080p Turbo video generation

Key Features

  • Automatic Mode Routing: If input.image_urls has a value, the request is handled as image-to-video. Otherwise it is handled as text-to-video
  • Image Input: In image-to-video mode, image_urls[0] is used as the first-frame image
  • Flexible Duration: 3 to 15 seconds. If omitted, the default duration is 5 seconds
  • Aspect Ratios: 16:9, 9:16, and 1:1 for text-to-video mode
  • Multi-Shot: Use multi_prompt for multi-shot storytelling with per-shot prompts and durations
  • Billing: Usage is billed by video duration

Authorizations

Authorization
string
header
required

All API endpoints require Bearer Token authentication.

Get your API Key from the API Key Management page, then add it to the request header:

Body

application/json
model
enum<string>
required

Kling 3.0 Turbo model identifier

Available options:
kling-3.0-turbo/standard,
kling-3.0-turbo/pro
Example:

"kling-3.0-turbo/standard"

input
object
required

Input parameters for generation. If image_urls has a value, image_urls[0] is used as the first-frame image and the request is routed to image-to-video.

callback_url
string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

Response

200 - application/json

Task submitted successfully

code
integer
required

HTTP status code

Example:

200

data
object
required