Kling Video 3.0: Kuaishou's flagship text/image-to-video model generating cinematic videos up to 15 seconds with multi-shot control, native audio, start/end frame images, and a dedicated 4K mode.
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-video",
"input": {
"mode": "pro",
"prompt": "First-person POV of a roller coaster plunging into the mouth of an erupting volcano. The track spirals down through rivers of glowing orange lava, sparks and embers flying past the camera. The coaster banks hard around a pillar of molten rock, then launches upward through a vent, bursting out of the volcano's crater into a dazzling sunset sky above the clouds. Wind roaring, riders screaming with excitement, the deep rumble of the volcano.",
"duration": 15,
"aspect_ratio": "16:9",
"generate_audio": true
}
}'| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | - | Text prompt for video generation. Max 2500 characters |
mode | string | No | pro | 'standard' generates 720p, 'pro' generates 1080p, '4k' generates 4K standardpro4k |
duration | integer | No | 5 | Video duration in seconds (3-15) |
start_image | string | No | - | First frame image (.jpg/.jpeg/.png, max 10MB, min 300px, ratio 1:2.5 to 2.5:1) |
end_image | string | No | - | Last frame image. Requires start_image |
aspect_ratio | string | No | 16:9 | Aspect ratio. Ignored when start_image is provided 16:99:161:1 |
multi_prompt | string | No | - | JSON array of shot definitions for multi-shot mode, e.g. [{"prompt":"...","duration":3}] (max 6 shots, min 1s per shot, total must equal duration) |
generate_audio | boolean | No | false | Generate native audio for the video (raises the per-second price at standard/pro tiers) |
negative_prompt | string | No | - | Things you do not want to see in the video. Max 2500 characters |
There are 3 ways to provide files for the start_imageend_image 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-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-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 long-form pro-tier shot 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-video",
"input": {
"mode": "pro",
"prompt": "First-person POV of a roller coaster plunging into the mouth of an erupting volcano. The track spirals down through rivers of glowing orange lava, sparks and embers flying past the camera. The coaster banks hard around a pillar of molten rock, then launches upward through a vent, bursting out of the volcano's crater into a dazzling sunset sky above the clouds. Wind roaring, riders screaming with excitement, the deep rumble of the volcano.",
"duration": 15,
"aspect_ratio": "16:9",
"generate_audio": true
}
}'Three coherent shots in one generation at the cheapest tier
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-video",
"input": {
"mode": "standard",
"prompt": "A day in the life of a lighthouse keeper on a remote northern island",
"multi_prompt": "[{\"prompt\":\"Dawn breaks over a rocky island, the lighthouse silhouetted against pink clouds\",\"duration\":3},{\"prompt\":\"The keeper climbs the spiral staircase, lantern light flickering on stone walls\",\"duration\":3},{\"prompt\":\"Aerial pull-back reveals the lighthouse beam sweeping across a stormy sea at dusk\",\"duration\":3}]",
"duration": 9,
"aspect_ratio": "16:9",
"generate_audio": false
}
}'POST /v1/predictions