# Kling v3 Video

> Kling Video 3.0: Generate cinematic videos up to 15 seconds with multi-shot control, native audio, and improved consistency

- **Provider**: replicate
- **Model ID**: kwaivgi/kling-v3-video
- **Category**: video_generation
- **Credits**: 2610 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `multi_prompt` (string, optional): JSON array of shot definitions for multi-shot mode. Each shot: {"prompt": "...", "duration": N}. Max 6 shots, min 1s per shot, total must equal duration.
- `end_image` (string, optional): Last frame image. Requires start_image. Supports .jpg/.jpeg/.png, max 10MB, min 300px.
- `prompt` (string, **required**): Text prompt for video generation. Max 2500 characters.
- `aspect_ratio` (string, optional): Aspect ratio. Ignored when start_image is provided. (Default: `16:9`; Options: `16:9`, `9:16`, `1:1`)
- `duration` (integer, optional): Video duration in seconds. (Default: `5`; Range: min: 3, max: 15)
- `start_image` (string, optional): First frame image. Supports .jpg/.jpeg/.png, max 10MB, min 300px, aspect ratio 1:2.5 to 2.5:1.
- `negative_prompt` (string, optional): Things you do not want to see in the video. Max 2500 characters. (Default: ``)
- `mode` (string, optional): 'standard' generates 720p, 'pro' generates 1080p, '4k' generates 4K. (Default: `pro`; Options: `standard`, `pro`, `4k`)
- `generate_audio` (boolean, optional): Generate native audio for the video. (Default: `False`)

## Example Request

```json
{
  "model": "kwaivgi/kling-v3-video",
  "input": {
    "mode": "pro",
    "duration": 15,
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "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."
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

kwaivgi, kling, video-generation, multi-shot, native-audio, 4k, cinematic, flagship

## Documentation

https://replicate.com/kwaivgi/kling-v3-video