---
title: Kling VIDEO O1 Pro | Runware Docs
url: https://runware.ai/docs/models/klingai-video-o1-pro
description: Unified multimodal video model for precise AI editing
---
# Kling VIDEO O1 Pro

Kling VIDEO O1 Pro is a unified multimodal video foundation model for controllable generation and instruction based editing. It supports text prompts, visual references, and video input so developers can build high control pipelines for pacing, transitions, object changes, and style revisions.

- **ID**: `klingai:kling@o1`
- **Status**: api-only
- **Creator**: Kling AI
- **Release Date**: December 1, 2025
- **Capabilities**: Text to Video, Image to Video, Video to Video, Edit

## Pricing

- **1080p · T2V · 1s**: `$0.112`
- **1080p · I2V · 1s**: `$0.112`
- **1080p · R2V · 1s**: `$0.168`

## Compatibility & Validation

Provide exactly one of: `inputs.frameImages` or `inputs.referenceImages` or `width/height`.

---

When `inputs.frameImages` is provided, `duration` is limited to `5`, `10`.

---

When `inputs.referenceImages` or `inputs.referenceVideos` is provided, `inputs.referenceImages` is limited to 7 items and `duration` must be between `3` and `10`.

---

When `inputs.video` is provided, `inputs.referenceImages` is limited to 4 items.

---

`width` and `height` must be used together.

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `1080p (16:9)` | `1920x1080` |
| `1080p (1:1)` | `1440x1440` |
| `1080p (9:16)` | `1080x1920` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/klingai-video-o1-pro#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `videoInference`

Identifier for the type of task being performed

### [taskUUID](https://runware.ai/docs/models/klingai-video-o1-pro#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/klingai-video-o1-pro#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Video output type.

**Allowed values**: `URL`

### [outputFormat](https://runware.ai/docs/models/klingai-video-o1-pro#request-outputformat)

- **Type**: `string`
- **Default**: `MP4`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`MP4\`: Widely supported video container (H.264), recommended for general use.
- \`WEBM\`: Optimized for web delivery.
- \`MOV\`: QuickTime format, common in professional workflows (Apple ecosystem).

**Allowed values**: `MP4` `WEBM` `MOV`

### [outputQuality](https://runware.ai/docs/models/klingai-video-o1-pro#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/klingai-video-o1-pro#request-webhookurl)

- **Type**: `string`
- **Format**: `URI`

Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/platform/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/klingai-video-o1-pro#request-deliverymethod)

- **Type**: `string`
- **Default**: `async`

Determines how the API delivers task results.

**Allowed values**:

- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse. Required for long-running tasks like video generation.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/platform/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/klingai-video-o1-pro#request-uploadendpoint)

- **Type**: `string`
- **Format**: `URI`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/klingai-video-o1-pro#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (2 properties)`

Content safety checking configuration for video generation.

#### [checkContent](https://runware.ai/docs/models/klingai-video-o1-pro#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`
- **Default**: `false`

Enable or disable content safety checking. When enabled, defaults to `fast` mode.

#### [mode](https://runware.ai/docs/models/klingai-video-o1-pro#request-safety-mode)

- **Path**: `safety.mode`
- **Type**: `string`
- **Default**: `none`

Safety checking mode for video generation.

**Allowed values**:

- `none` Disables checking.
- `fast` Checks key frames.
- `full` Checks all frames.

### [ttl](https://runware.ai/docs/models/klingai-video-o1-pro#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/klingai-video-o1-pro#request-includecost)

- **Type**: `boolean`
- **Default**: `false`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/klingai-video-o1-pro#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `4`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [referenceImages](https://runware.ai/docs/models/klingai-video-o1-pro#request-inputs-referenceimages)

- **Path**: `inputs.referenceImages`
- **Type**: `array of strings`

List of reference images (UUID, URL, Data URI, or Base64).

### [frameImages](https://runware.ai/docs/models/klingai-video-o1-pro#request-inputs-frameimages)

- **Path**: `inputs.frameImages`
- **Type**: `array of strings or objects`

An array of frame-specific image inputs to guide video generation. Each item can be either a plain image input (UUID, URL, Data URI, or Base64) or an object that pairs an image with a target frame position.

The `frameImages` parameter allows you to constrain specific frames within the video sequence, ensuring that particular visual content appears at designated points. This is different from `referenceImages`, which provide overall visual guidance without constraining specific timeline positions.

When the `frame` parameter is omitted, automatic distribution rules apply:

- **1 image**: Used as the first frame.
- **2 images**: First and last frames.

**Examples**:

**Shorthand format:** When you don't need to specify a frame position, you can pass a plain image input directly.

```json
"frameImages": [
  "aac49721-1964-481a-ae78-8a4e29b91402"
]
```

**Object format:** When you need to specify a frame position, use an object with `image` and `frame`.

```json
"frameImages": [
  {
    "image": "aac49721-1964-481a-ae78-8a4e29b91402",
    "frame": "first"
  }
]
```

**First and last frames:** With two images, they automatically become the first and last frames of the video sequence. You can mix shorthand and object formats.

```json
"frameImages": [
  "aac49721-1964-481a-ae78-8a4e29b91402",
  {
    "image": "3ad204c3-a9de-4963-8a1a-c3911e3afafe",
    "frame": "last"
  }
]
```

**Format 1: string[]**:

- **Type**: `string`

Image input (UUID, URL, Data URI, or Base64).

**Format 2: object[]**:

#### [image](https://runware.ai/docs/models/klingai-video-o1-pro#request-inputs-frameimages-format-2-image)

- **Path**: `inputs.frameImages.image`
- **Type**: `string`
- **Required**: true

Image input (UUID, URL, Data URI, or Base64).

#### [frame](https://runware.ai/docs/models/klingai-video-o1-pro#request-inputs-frameimages-format-2-frame)

- **Path**: `inputs.frameImages.frame`
- **Type**: `object`

Target frame position for the image. Supports first and last frame.

**Allowed values**:

- `first` First frame of the video.
- `last` Last frame of the video.
- `0` Frame index 0 (first frame).
- `-1` Frame index -1 (last frame).

### [video](https://runware.ai/docs/models/klingai-video-o1-pro#request-inputs-video)

- **Path**: `inputs.video`
- **Type**: `string`

Video input (UUID or URL). Source video for prompt-based editing. Dimensions and duration match the input video.

### [referenceVideos](https://runware.ai/docs/models/klingai-video-o1-pro#request-inputs-referencevideos)

- **Path**: `inputs.referenceVideos`
- **Type**: `array of strings`

List of reference videos (UUID, URL).

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/klingai-video-o1-pro#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `klingai:kling@o1`

Identifier of the model to use for generation.

**Learn more** (3 resources):

- [Text To Image: Model Selection The Foundation Of Generation](https://runware.ai/docs/guides/text-to-image#model-selection-the-foundation-of-generation) (guide)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/guides/image-inpainting#model-specialized-inpainting-models) (guide)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/guides/image-outpainting#other-critical-parameters) (guide)

### [positivePrompt](https://runware.ai/docs/models/klingai-video-o1-pro#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `2`
- **Max**: `2500`

Text prompt describing elements to include in the generated output.

**Learn more** (2 resources):

- [Text To Image: Prompts Guiding The Generation](https://runware.ai/docs/guides/text-to-image#prompts-guiding-the-generation) (guide)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/guides/image-outpainting#other-critical-parameters) (guide)

### [width](https://runware.ai/docs/models/klingai-video-o1-pro#request-width)

- **Type**: `integer`
- **Required**: true
- **Paired with**: height

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Image To Image: Dimensions Changing Aspect Ratio](https://runware.ai/docs/guides/image-to-image#dimensions-changing-aspect-ratio) (guide)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/guides/image-outpainting#dimensions-critical-for-outpainting) (guide)

### [height](https://runware.ai/docs/models/klingai-video-o1-pro#request-height)

- **Type**: `integer`
- **Required**: true
- **Paired with**: width

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Image To Image: Dimensions Changing Aspect Ratio](https://runware.ai/docs/guides/image-to-image#dimensions-changing-aspect-ratio) (guide)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/guides/image-outpainting#dimensions-critical-for-outpainting) (guide)

### [duration](https://runware.ai/docs/models/klingai-video-o1-pro#request-duration)

- **Type**: `integer`
- **Default**: `5`

Length of the generated video in seconds. The total number of frames produced is determined by duration multiplied by the model's frame rate (fps).

**Provider Settings**

Parameters specific to this model provider. These must be nested inside the \`providerSettings.klingai\` object.

### [fast](https://runware.ai/docs/models/klingai-video-o1-pro#request-providersettings-klingai-fast)

- **Path**: `providerSettings.klingai.fast`
- **Type**: `boolean`
- **Default**: `false`

Enable fast generation mode. Requires input videos between 6-20 seconds (standard mode: 3-10 seconds). Only applies to video editing workflows.

### [keepOriginalSound](https://runware.ai/docs/models/klingai-video-o1-pro#request-providersettings-klingai-keeporiginalsound)

- **Path**: `providerSettings.klingai.keepOriginalSound`
- **Type**: `boolean`
- **Default**: `false`

Maintain the original sound from the reference video.

## Response Parameters

### [taskType](https://runware.ai/docs/models/klingai-video-o1-pro#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `videoInference`

Type of the task.

### [taskUUID](https://runware.ai/docs/models/klingai-video-o1-pro#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the task.

### [videoUUID](https://runware.ai/docs/models/klingai-video-o1-pro#response-videouuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output video.

### [videoURL](https://runware.ai/docs/models/klingai-video-o1-pro#response-videourl)

- **Type**: `string`
- **Format**: `URI`

URL of the output video.

### [videoBase64Data](https://runware.ai/docs/models/klingai-video-o1-pro#response-videobase64data)

- **Type**: `string`

Base64-encoded video data.

### [videoDataURI](https://runware.ai/docs/models/klingai-video-o1-pro#response-videodatauri)

- **Type**: `string`
- **Format**: `URI`

Data URI of the output video.

### [seed](https://runware.ai/docs/models/klingai-video-o1-pro#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/klingai-video-o1-pro#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/klingai-video-o1-pro#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### Porcelain Automaton Garden Waltz (Image to Video)

[Watch video](https://assets.runware.ai/examples/klingai-video-o1-pro/c9443cbf-d7ae-4507-aea5-118c292aec92.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "4b240d50-1ef6-40ef-b186-290cc09b3413",
  "model": "klingai:kling@o1",
  "positivePrompt": "Animate a graceful porcelain automaton ballerina inside an opulent indoor topiary hall. Begin from the supplied frame image and create a dreamy, high-end cinematic sequence with gentle camera orbit and slow push-in movement. The automaton makes delicate rotational dance motions, fingertips and skirt panels moving with precise mechanical elegance. Spiral hedges subtly sway, suspended glass prisms catch shifting light, petals drift through the air, and thin morning haze creates depth beams across marble paths. Emphasize polished ceramic texture, cobalt floral patterns, gold filigree joints, refined fantasy realism, smooth motion, rich depth, lyrical atmosphere, and coherent subject identity throughout the shot.",
  "duration": 5,
  "inputs": {
    "frameImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/15cc1d41-d463-45ff-833e-2e8d1f28a05c.jpg",
        "frame": "first"
      }
    ]
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "4b240d50-1ef6-40ef-b186-290cc09b3413",
  "videoUUID": "79363e4b-f3b2-4129-b123-c89c8232158a",
  "videoURL": "https://vm.runware.ai/video/os/a24d12/ws/5/vi/79363e4b-f3b2-4129-b123-c89c8232158a.mp4",
  "cost": 0.56
}
```

---

### Clockwork Orchard Chase Sequence (Video to Video)

[Watch video](https://assets.runware.ai/examples/klingai-video-o1-pro/44c9b353-7465-4f02-af0c-79d6951f233e.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "3bde4059-ffc8-4afc-b15a-b87c48c8aa51",
  "model": "klingai:kling@o1",
  "positivePrompt": "Transform the source footage into a fantastical clockwork orchard at golden dawn. Replace the farmland with rows of towering fruit trees made of polished brass, copper leaves, and delicate gear-driven branches. The runner becomes a nimble courier in a cream canvas coat carrying a satchel of glowing mechanical pears. As the camera advances, ripe metal fruit clicks open to release tiny paper birds that spiral through the air. Add drifting pollen-like sparks, rotating irrigation wheels, and distant wind-powered harvest machines on the horizon. Preserve the original movement, pacing, and camera trajectory of the source video while enhancing it with cinematic depth, rich atmospheric perspective, elegant mechanical detail, and a sense of playful urgency.",
  "providerSettings": {
    "klingai": {
      "keepOriginalSound": true
    }
  },
  "inputs": {
    "video": "https://assets.runware.ai/assets/inputs/1a0b80d4-34bc-4c77-be12-370f5eb71bf2.mp4"
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "3bde4059-ffc8-4afc-b15a-b87c48c8aa51",
  "videoUUID": "3a14d39f-4190-4e55-851c-3a6222f48d99",
  "videoURL": "https://vm.runware.ai/video/os/a20d05/ws/5/vi/3a14d39f-4190-4e55-851c-3a6222f48d99.mp4",
  "cost": 1.008
}
```

---

### Moonlit Cliffside Violin Duel (Text to Video)

[Watch video](https://assets.runware.ai/examples/klingai-video-o1-pro/2741f0e4-865c-43c1-8bdc-ff603487a391.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "c48c06bf-4095-4d07-a51a-c914d807c108",
  "model": "klingai:kling@o1",
  "positivePrompt": "On a narrow wind-carved cliff above a roaring black sea, two rival violinists face each other on separate stone platforms connected by a fractured arch bridge. Midnight sky with fast-moving silver clouds and a huge low moon. Their music seems to shape the world: each bow stroke sends visible ripples through the air, scattering pale sparks and bending mist into spirals. One performer wears a tailored ivory coat with long flowing tails, the other a deep crimson coat with metallic embroidery; both move with balletic precision. Start with a wide aerial shot circling the cliff, then push in as the duel intensifies. Waves crash far below, loose pebbles skitter across the rock, fabric whips in the wind, hair and coats react naturally. The bridge begins to crack as the musical contest peaks, small stones falling into the surf. Finish on a close-up of both musicians locking eyes as the final note hangs in the air and the moonlight floods the scene. Ultra-cinematic, dramatic contrast, rich atmosphere, highly detailed textures, fluid character animation, dynamic camera movement, realistic physics, epic and tense mood.",
  "width": 1920,
  "height": 1080,
  "duration": 10
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "c48c06bf-4095-4d07-a51a-c914d807c108",
  "videoUUID": "d9b23abc-d3bc-4715-9c01-dc9c21d58e1a",
  "videoURL": "https://vm.runware.ai/video/os/a10d08/ws/5/vi/d9b23abc-d3bc-4715-9c01-dc9c21d58e1a.mp4",
  "cost": 1.12
}
```

---

### Arctic Glasswright Workshop Interior (Image to Video)

[Watch video](https://assets.runware.ai/examples/klingai-video-o1-pro/ee302686-b6d1-4d45-98fe-a9fab55ed585.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "59e55a01-8a4a-4740-8beb-f08b0a4aa7bc",
  "model": "klingai:kling@o1",
  "positivePrompt": "Using both reference images as the visual foundation, create a cinematic realistic scene inside a polar glassmaking atelier. A solitary glasswright carefully shapes a luminous translucent sphere at the workbench while warm furnace light flickers across ice walls and hanging crystal instruments. Fine breath vapor curls in the cold air, tiny sparks rise, and frost glitters on tools and shelves. Start with a medium-wide establishing shot of the workshop, then slowly push in as the artisan rotates the glowing piece with calm precision. Add subtle environmental motion: swaying suspended tubing, drifting steam, shimmering reflections through glass, and soft snow visible beyond a distant doorway. End on a close view of the finished orb reflecting the entire room like a miniature frozen world. Rich contrast between amber firelight and deep cyan ice, elegant textures, highly controlled motion, premium cinematic detail.",
  "width": 1920,
  "height": 1080,
  "duration": 5,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/eb01611e-0f0d-4572-b567-41db63ee720c.jpg",
      "https://assets.runware.ai/assets/inputs/49f92964-fc1c-418e-a347-38804169bae0.jpg"
    ]
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "59e55a01-8a4a-4740-8beb-f08b0a4aa7bc",
  "videoUUID": "fd7d9e1d-d0b9-4a7d-90c1-d1d3ad237d5b",
  "videoURL": "https://vm.runware.ai/video/os/a02d21/ws/5/vi/fd7d9e1d-d0b9-4a7d-90c1-d1d3ad237d5b.mp4",
  "cost": 0.56
}
```

---

### Cathedral Aquarium Time Drift (Image to Video)

[Watch video](https://assets.runware.ai/examples/klingai-video-o1-pro/746bd1b1-e71d-4d3c-b8f9-d03eb2e740ea.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "f7ad0dfa-6192-43b0-a1e3-47e22afa9dfc",
  "model": "klingai:kling@o1",
  "positivePrompt": "A cinematic transformation sequence inside a colossal cathedral converted into an aquarium. Begin on the first frame composition and evolve smoothly toward the last frame image. Slow floating camera movement through the central aisle, reflections rippling across stone, fish circling through towering tanks, droplets hanging in the air, subtle debris, drifting plants, shifting light rays through stained glass, a dreamlike passage of many years compressed into seconds. Emphasize continuity of architecture and subject placement while gradually changing the environment from pristine aquatic grandeur into suspended watery ruin and overgrown wonder. Highly detailed textures, atmospheric depth, graceful motion, natural physics, epic yet intimate mood.",
  "duration": 5,
  "inputs": {
    "frameImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/3a29e936-2c6b-4576-adae-e8a1394b6149.jpg",
        "frame": "first"
      },
      {
        "image": "https://assets.runware.ai/assets/inputs/8846fe54-01e5-4c8b-9488-90bcff8212c6.jpg",
        "frame": "last"
      }
    ]
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "f7ad0dfa-6192-43b0-a1e3-47e22afa9dfc",
  "videoUUID": "fb09d737-e43d-4a2d-9b2e-604730aa1a04",
  "videoURL": "https://vm.runware.ai/video/os/a21d05/ws/5/vi/fb09d737-e43d-4a2d-9b2e-604730aa1a04.mp4",
  "cost": 0.56
}
```