# Kling v3 Pro — Image to Video

> Kling 3.0 Pro: Top-tier image-to-video with cinematic visuals, fluid motion, and native audio generation, with custom element support.

## Overview

- **Endpoint**: `https://api.runflow.io/v1/run/kuaishou/kling-video/v3/pro/image-to-video`
- **Model ID**: `kuaishou/kling-video/v3/pro/image-to-video`
- **Provider**: Kuaishou
- **License**: commercial
- **Last Updated**: 2026-04-05

## Pricing

- **Base price**: $0.14/second
- **Note**: Usage-based, per seconds
## Input Schema

### `prompt` (string, optional)

Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both.

### `voice_ids` (string, optional)

Optional Voice IDs for video generation. Reference voices in your prompt with <<<voice_1>>> and <<<voice_2>>> (maximum 2 voices per task). Get voice IDs from the kling video create-voice endpoint: https://fal.ai/models/fal-ai/kling-video/create-voice

### `elements` (string, optional)

Elements (characters/objects) to include in the video. Each example can either be an image set (frontal + reference images) or a video. Reference in prompt as @Element1, @Element2, etc.

### `multi_prompt` (array, optional)

List of prompts for multi-shot video generation. If provided, divides the video into multiple shots.

### `generate_audio` (boolean, optional)

Whether to generate native audio for the video. Supports Chinese and English voice output. Other languages are automatically translated to English. For English speech, use lowercase letters; for acronyms or proper nouns, use uppercase.
- **Default**: `true`

### `duration` (string, optional)

The duration of the generated video in seconds
- **Default**: `5`
- **Options**: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`

### `shot_type` (string, optional)

The type of multi-shot video generation. Required when multi_prompt is provided.
- **Default**: `customize`

### `start_image_url` (image, required)

URL of the image to be used for the video

### `end_image_url` (image, optional)

URL of the image to be used for the end of the video

### `negative_prompt` (string, optional)


- **Default**: `blur, distort, and low quality`

### `cfg_scale` (number, optional)

The CFG (Classifier Free Guidance) scale is a measure of how close you want
            the model to stick to your prompt.
- **Default**: `0.5`
- **Min**: 0
- **Max**: 1

## Usage Examples

### cURL

```bash
curl -X POST https://api.runflow.io/v1/run/kuaishou/kling-video/v3/pro/image-to-video \
  -H "Authorization: Bearer $RUNFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A professional headshot, soft studio lighting"
  }'
```

### Python

```python
import requests

response = requests.post(
    "https://api.runflow.io/v1/run/kuaishou/kling-video/v3/pro/image-to-video",
    headers={"Authorization": "Bearer RUNFLOW_API_KEY"},
    json={
        "prompt": "A professional headshot, soft studio lighting",
    },
)

data = response.json()
print(data["video"]["url"])
```

### JavaScript

```javascript
const response = await fetch(
  "https://api.runflow.io/v1/run/kuaishou/kling-video/v3/pro/image-to-video",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer RUNFLOW_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt: "A professional headshot, soft studio lighting",
    }),
  }
);

const data = await response.json();
console.log(data.video.url);
```

## Additional Resources

- [Playground](https://www.runflow.io/models/kuaishou/kling-video/v3/pro/image-to-video)
- [API Reference](https://www.runflow.io/models/kuaishou/kling-video/v3/pro/image-to-video/api)
- [Documentation](https://www.runflow.io/docs)