Developer docs
Docs Kling /kling/v1/videos/omni-video
API reference

Omni-Video

Kling Omni unified video generation: text-to-video, image reference, first/last frame, video edit, subject reference, and multi-shot.

POST/kling/v1/videos/omni-video

Body Parametersapplication/json

aspect_ratio string

Aspect ratio. It is recommended that this field be required when the first frame is not used and is not used for video editing.

callback_url string · uri

Task completion callback address must be reachable by the public network

duration oneOf

Video duration (seconds). o1: 5/10; v3-omni: 3~15; when refer_type=base, it is covered by video detection and does not need to be transmitted.

element_list array

List of subject references.

items
object object
external_task_id string

Caller external task ID, used for business correlation

image_list array

Reference figure list. Used for subject/scene/style reference or first and last frames.

items
object object
mode string

Generate schema. The default gateway is pro; 4k only kling-v3-omni.

model_name* string

Omni model name, required. o1 does not support sound/4k/multi_shot; v3-omni is fully functional.

multi_prompt array

Customized storyboard list. Required when shot_type=customize, up to 6 shots.

items
object object
multi_shot boolean

Whether to use multiple lenses, default false. Only kling-v3-omni can be true.

prompt string

Text prompt word, ≤2500 characters. Required when multi_shot=false; invalid when multi_shot=true.

shot_type string

Storyboarding method. Required when multi_shot=true; customize must match multi_prompt.

sound string

Audible switch. on only kling-v3-omni; passing on from o1 will result in 400.

video_list array

Reference video list, maximum 1.

items
object object
watermark_info object

Watermark configuration, gateway transparent transmission

properties
enabled boolean

true generates watermarked results

Responses

200 application/json
response-200 object
400 Bad request or validation failed application/json
response-400 object
properties
error* object
401 Missing or invalid API Key application/json
response-401 object
Request Body Example Recommended for novices: Omni Vincent Video · Minimum available submission path (o1)
1{
2"aspect_ratio": "16:9",
3"duration": "5",
4"mode": "pro",
5"model_name": "kling-video-o1",
6"multi_shot": false,
7"prompt": "A cinematic aerial shot over a misty mountain lake at sunrise"
8}
Code Sample cURL
1curl -X POST "https://api.digislash.com/kling/v1/videos/omni-video" \
2-H "Authorization: Bearer <API Key>" \
3-H "Content-Type: application/json" \
4-d '{
5"aspect_ratio": "16:9",
6"duration": "5",
7"mode": "pro",
8"model_name": "kling-video-o1",
9"multi_shot": false,
10"prompt": "A cinematic aerial shot over a misty mountain lake at sunrise"
11}'
Response
1▼{
2"code": 0,
3▼"data": {
4"task_id": "task_example_001"
5},
6"message": "success"
7}