Skip to main content
POST
/
kling
/
v1
/
videos
/
text2video
Create Text-to-Video Task
curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A cat walking through a field of sunflowers at golden hour",
  "model_name": "kling-v3",
  "negative_prompt": "<string>",
  "mode": "std",
  "duration": "5",
  "aspect_ratio": "16:9",
  "cfg_scale": 0.5,
  "multi_shot": false,
  "shot_type": "customize",
  "multi_prompt": [
    {
      "index": 123,
      "prompt": "<string>",
      "duration": "<string>"
    }
  ],
  "sound": "off",
  "camera_control": {
    "type": "simple",
    "config": {
      "horizontal": 123,
      "vertical": 123,
      "pan": 123,
      "tilt": 123,
      "roll": 123,
      "zoom": 123
    }
  },
  "watermark_info": {
    "enabled": true
  },
  "callback_url": "<string>",
  "external_task_id": "<string>"
}
'
{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-v3",
  "status": "<string>",
  "progress": 0,
  "created_at": 1773130665
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
prompt
string
required

Positive text prompt. Max 2500 characters.

Maximum string length: 2500
Example:

"A cat walking through a field of sunflowers at golden hour"

​
model_name
enum<string>

Model name

Available options:
kling-v3
Example:

"kling-v3"

​
negative_prompt
string

Negative text prompt. Max 2500 characters.

Maximum string length: 2500
​
mode
enum<string>
default:std

std: Standard (cost-effective). pro: Professional (higher quality).

Available options:
std,
pro
​
duration
enum<string>
default:5

Video duration in seconds (3-15).

Available options:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
Example:

"5"

​
aspect_ratio
enum<string>
default:16:9

Aspect ratio of generated video (width:height).

Available options:
16:9,
9:16,
1:1
Example:

"16:9"

​
cfg_scale
number
default:0.5

Prompt relevance (0-1). Higher = stronger adherence. Not supported by kling-v2.x models.

Required range: 0 <= x <= 1
​
multi_shot
boolean
default:false

Enable multi-shot storyboarding. When true, prompt is ignored; use multi_prompt instead.

​
shot_type
enum<string>

Storyboard method. Required when multi_shot is true.

Available options:
customize,
intelligence
​
multi_prompt
object[]

Storyboard shots (1-6). Required when multi_shot is true and shot_type is customize.

​
sound
enum<string>
default:off

Generate sound with video. Only V2.6+ models.

Available options:
on,
off
​
camera_control
object

Camera movement control.

​
watermark_info
object
​
callback_url
string

Callback URL for task status notifications

​
external_task_id
string

Custom task ID. Must be unique per account.

Response

Task created

​
id
string
Example:

"860260753860210752"

​
task_id
string
Example:

"860260753860210752"

​
object
string
Example:

"video"

​
model
string
Example:

"kling-v3"

​
status
string
​
progress
integer
Example:

0

​
created_at
integer
Example:

1773130665