Create Video by Text

Request

Body Params application/json

model_name

string

required

Enumeration value:
kling-v1
kling-v1-5
kling-v1-6
kling-v2-master

prompt

string

required

Cannot exceed 2500 characters

negative_prompt

string

optional

Cannot exceed 2500 characters

cfg_scale

number

optional

The larger the value, the higher the creative relevance. The value range is: [0,1]

mode

string

required

Enumeration value:
std
pro

camera_control

object

optional

Control the camera movement mode. If not specified, it will be matched intelligently.

type

string

optional

Predefined camera movement types
Enumeration values: "simple", "down_back", "forward_up", "right_turn_forward", "left_turn_forward"
simple: simple camera movement, in this type, you can choose one of the six camera movements in "config"
down_back: the lens is pressed down and back ➡️ down and zoomed out, the config parameter does not need to be filled in for this type
forward_up: the lens moves forward and tilts up ➡️ pushes up, the config parameter does not need to be filled in for this type
right_turn_forward: rotate right first and then move forward ➡️ right rotation push forward, the config parameter does not need to be filled in for this type
left_turn_forward: rotate left first and move forward ➡️ left rotation push forward, the config parameter does not need to be filled in for this type
Enumeration values:
simple
down_back
forward_up
right_turn_forward
left_turn_forward

config

object

optional

Contains six fields to specify the movement or change of the camera in different directions
Required when the camera movement type is specified as simple, and not required when other types are specified
Select 1 from the following 6 parameters, that is, only one parameter can be non-0, and the rest of the parameters are 0

aspect_ratio

string

optional

Enumeration value:
16:9
9:16
1:1

duration

string

required

Set duration

Example

{
    "model_name": "kling-v1",
    "prompt": "A 20-year-old girl, with an oval face, delicate features, long black hair, fair skin, and ambient light, wearing a short white skirt, sitting on a bench beside the street, smiling and shaking her hair",
    "mode": "std",
    "aspect_ratio": "1:1",
    "duration": "5"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/kling/v1/videos/text2video' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "kling-v1",
    "prompt": "A 20-year-old girl, with an oval face, delicate features, long black hair, fair skin, and ambient light, wearing a short white skirt, sitting on a bench beside the street, smiling and shaking her hair",
    "mode": "std",
    "aspect_ratio": "1:1",
    "duration": "5"
}'

Responses

🟢200OK

application/json

Body

code

integer

required

message

string

required

request_id

string

required

data

object

required

task_id

string

required

task_status

string

required

created_at

integer

required

updated_at

integer

required

Example

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "CmYgjmbyMToAAAAAAF6svw",
  "data": {
    "task_id": "CmYgjmbyMToAAAAAAF6svw",
    "task_status": "submitted",
    "created_at": 1727338013674,
    "updated_at": 1727338013674
  }
}