Skip to main content
Core.Today
|
KuaishouSlowUltra

Kling v3 Omni Video

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.

2610 credits
per 5s pro (1080p) video, no audio (default) โ€” billed per second: standard 391-521/s, pro 521-652/s, 4k 978/s
Three quality tiers: standard (720p), pro (1080p, default), and 4k
Reference-based generation from up to 7 images for character/style consistency
Video editing mode via reference_video + video_reference_type=base
Style and camera reference via reference_video + video_reference_type=feature
Multi-shot control via multi_prompt (up to 6 sequential shots)
Optional native audio generation (off by default)

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

Quick Start

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
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes-Text prompt (max 2500 chars). Supports <<<image_1>>>, <<<video_1>>> template references
start_imagestringNo-First frame image for image-to-video
end_imagestringNo-Last frame image (requires start_image)
reference_imagesarrayNo-Reference images for elements, scenes, or styles (max 7 without video, 4 with video)
reference_videostringNo-Reference video (3-10s) for style/camera reference or video editing
video_reference_typestringNofeature'feature' for style/camera reference, 'base' for video editing
featurebase
keep_original_soundbooleanNotrueKeep original sound from the reference video
generate_audiobooleanNofalseGenerate native audio. Mutually exclusive with reference video
modestringNopro'standard' generates 720p, 'pro' generates 1080p, '4k' generates 4K (no reference_video)
standardpro4k
aspect_ratiostringNo16:9Aspect ratio. Required when not using a start frame or video editing
16:99:161:1
durationintegerNo5Video duration in seconds (3-15). Ignored for video editing (base)
multi_promptstringNo-JSON array of shot definitions for multi-shot mode, e.g. [{"prompt":"...","duration":3}] (max 6 shots)

How to Provide File Input

There are 3 ways to provide files for the start_imageend_imagereference_imagesreference_video parameters:

Recommended

Direct Upload (Multipart)

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"

Image URL

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"
  }
}
See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Pro (1080p) with Audio

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
  }
}'

Standard (720p), No Audio

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
  }
}'

Tips & Best Practices

1mode defaults to pro (1080p) and generate_audio defaults to false โ€” omitting both bills the pro/no-audio rate
24k mode is priced the same whether or not generate_audio is set, but does not support reference_video
3Adding audio raises the price about 25-33% at the standard/pro tiers
4Use multi_prompt for coherent multi-shot sequences instead of chaining separate generations
5video_reference_type=base edits an existing clip; =feature only borrows its style/camera motion

Use Cases

Reference-image-driven brand or character-consistent video series
Editing an existing video clip with text instructions
Multi-shot mini-trailers with a single coherent prompt
4K hero shots for premium marketing content
Style transfer from a reference video's camera work