Skip to main content
POST
/
kling
/
v1
/
videos
/
omni-video
Create Video Task
curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/omni-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "kling-v3-omni",
  "prompt": "A cat walking gracefully across a sunlit garden",
  "mode": "pro",
  "aspect_ratio": "16:9",
  "duration": "5",
  "multi_shot": false,
  "shot_type": "customize",
  "multi_prompt": [
    {
      "index": 123,
      "prompt": "<string>",
      "duration": "<string>"
    }
  ],
  "image_list": [
    {
      "image_url": "<string>",
      "type": "first_frame"
    }
  ],
  "element_list": [
    {
      "element_id": 123
    }
  ],
  "video_list": [
    {
      "video_url": "<string>",
      "refer_type": "base",
      "keep_original_sound": "yes"
    }
  ],
  "sound": "off",
  "watermark_info": {
    "enabled": true
  },
  "callback_url": "<string>",
  "external_task_id": "<string>"
}
'
{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-v3-omni",
  "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
​
model_name
enum<string>

Model name

Available options:
kling-v3-omni
Example:

"kling-v3-omni"

​
prompt
string

Text prompt for video generation. Supports positive and negative descriptions. Use <<<element_1>>>, <<<image_1>>>, <<<video_1>>> to reference elements/images/videos. Required when multi_shot is false.

Maximum string length: 2500
Example:

"A cat walking gracefully across a sunlit garden"

​
mode
enum<string>
default:pro

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

Available options:
std,
pro
Example:

"pro"

​
aspect_ratio
enum<string>

Aspect ratio of generated video (width:height). Required when NOT using first-frame reference or video editing.

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

"16:9"

​
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"

​
multi_shot
boolean
default:false

Whether to generate multi-shot video. When true, prompt is ignored; use multi_prompt instead.

​
shot_type
enum<string>

Storyboard method. Required when multi_shot is true.

Available options:
customize
​
multi_prompt
object[]

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

​
image_list
object[]

Reference image list. Supports first/end frame, scene, style references. Formats .jpg/.jpeg/.png, max 10MB, min 300px, aspect ratio 1:2.5–2.5:1.

​
element_list
object[]

Reference element list from Kling element library.

​
video_list
object[]

Reference video list. MP4/MOV only, ≥3s, 720px–2160px, 24–60fps, max 200MB.

​
sound
enum<string>
default:off

Whether to generate sound with the video. Must be off when video_list is present.

Available options:
on,
off
​
watermark_info
object

Watermark configuration

​
callback_url
string

Callback URL for task status notifications

​
external_task_id
string

Custom task ID. Must be unique per account.

Response

Task created successfully

​
id
string

Task ID

Example:

"860260753860210752"

​
task_id
string

Task ID

Example:

"860260753860210752"

​
object
string
Example:

"video"

​
model
string
Example:

"kling-v3-omni"

​
status
string

Task status

​
progress
integer

Progress percentage

Example:

0

​
created_at
integer

Unix timestamp

Example:

1773130665