Text-to-video

Standard text-to-video and Omni/O1 use the same request method and path, with different request structures for their inputs.

POST/kling/v1/videos/text2video

Use Kling native fields directly. The platform handles authentication and routing without converting the payload to the common format.

Omni/O1 uses the same native create path and is distinguished by the model and media fields.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization header.

In: header

Request Body

application/json

Kling native text-to-video or Omni/O1 request.

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Kling native model ID, such as kling-v2-5-turbo or kling-v2-6. Available models are determined by the model list returned for the current API key.

Length1 <= length

prompt*string

Positive prompt, up to 2,500 characters.

Lengthlength <= 2500

negative_prompt?string

Negative prompt.

Lengthlength <= 2500

mode?string

Generation mode. V1.6 does not support pro.

Value in

"std"
"pro"

aspect_ratio?string

Output aspect ratio.

Default"16:9"

Value in

"16:9"
"9:16"
"1:1"

duration_string?string

Video duration in seconds.

Value in

"5"
"10"

cfg_scale?number

Prompt adherence strength.

Range0 <= value <= 1

sound?string

Whether to generate audio. Supported only by V2.6 and later models.

Value in

"on"
"off"

voice_list?array<>

List of referenced voices.

Itemsitems <= 2

callback?string

Task status callback URL.

Formaturi

params?string

Callback passthrough parameter.

Response Body

`application/json`

curl -X POST "https://example.com/kling/v1/videos/text2video" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "A cat singing on stage in a cinematic style",    "negative_prompt": "blurry, low resolution",    "mode": "std",    "aspect_ratio": "16:9",    "duration_string": "5",    "cfg_scale": 0.5,    "sound": "on",    "callback": "https://example.com/kling/callback",    "params": "user_id_123"  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "task_id": "task_id_here",
    "task_status": "submitted",
    "created_at": 1640995200000,
    "updated_at": 1640995200000
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`