Kling Video 3.0 Omni: a unified multimodal video model that generates and edits video from text, images, reference images, and existing video. Combines text-to-video, image-to-video, reference-based generation, and video editing with native audio and multi-shot control.
Test this model instantly in the Console Playground โ no code required
Copy usage instructions for Claude, ChatGPT, or other AI
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "kwaivgi/kling-v3-omni-video",
"input": {
"mode": "pro",
"prompt": "A Wes Anderson style movie trailer with symmetrical framing and pastel colors, ending on the full cast standing on the hotel steps",
"duration": 15,
"aspect_ratio": "16:9",
"generate_audio": true
}
}'| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | - | Text prompt (max 2500 chars). Supports <<<image_1>>>, <<<video_1>>> template references |
start_image | string | No | - | First frame image for image-to-video |
end_image | string | No | - | Last frame image (requires start_image) |
reference_images | array | No | - | Reference images for elements, scenes, or styles (max 7 without video, 4 with video) |
reference_video | string | No | - | Reference video (3-10s) for style/camera reference or video editing |
video_reference_type | string | No | feature | 'feature' for style/camera reference, 'base' for video editing featurebase |
keep_original_sound | boolean | No | true | Keep original sound from the reference video |
generate_audio | boolean | No | false | Generate native audio. Mutually exclusive with reference video |
mode | string | No | pro | 'standard' generates 720p, 'pro' generates 1080p, '4k' generates 4K (no reference_video) standardpro4k |
aspect_ratio | string | No | 16:9 | Aspect ratio. Required when not using a start frame or video editing 16:99:161:1 |
duration | integer | No | 5 | Video duration in seconds (3-15). Ignored for video editing (base) |
multi_prompt | string | No | - | JSON array of shot definitions for multi-shot mode, e.g. [{"prompt":"...","duration":3}] (max 6 shots) |
There are 3 ways to provide files for the start_imageend_imagereference_imagesreference_video parameters:
Attach files directly to POST /v1/predictions/upload. No separate upload step needed.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=kwaivgi/kling-v3-omni-video" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:start_image=@your_file.png"Pass a publicly accessible URL directly. You can also use file_url from the Storage API.
{
"model": "kwaivgi/kling-v3-omni-video",
"input": {
"prompt": "your prompt here",
"start_image": "https://example.com/image.jpg"
}
}Common parameters used when calling POST /v1/predictions.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Yes | - | Model identifier |
input | object | Yes | - | Object containing the model-specific parameters from the table above |
output_folder | string | No | - | Folder path for output files (max 256 chars, '..' not allowed) |
webhook_url | string | No | - | Webhook URL to call on completion |
is_public | boolean | No | false | If true, output files are also available via permanent public URLs |
A multi-shot cinematic trailer at the pro tier with native audio enabled
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "kwaivgi/kling-v3-omni-video",
"input": {
"mode": "pro",
"prompt": "A Wes Anderson style movie trailer with symmetrical framing and pastel colors, ending on the full cast standing on the hotel steps",
"duration": 15,
"aspect_ratio": "16:9",
"generate_audio": true
}
}'The cheapest tier for quick iteration, audio generation left off
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "kwaivgi/kling-v3-omni-video",
"input": {
"mode": "standard",
"prompt": "A paper airplane gliding through a sunlit office, weaving between desks",
"duration": 5,
"aspect_ratio": "16:9",
"generate_audio": false
}
}'POST /v1/predictions