# KwaiVGI Kling 3.0 Omni Pro Reference to Video API

> Kling 3.0 Omni Pro Reference to Video by Kuaishou generates a 3-10 second 1080p video that keeps characters and objects from reference images consistent.

Source: https://www.sandbase.ai/models/kwaivgi/kling-video/3.0/omni/pro/reference-to-video
API reference: https://www.sandbase.ai/models/kwaivgi/kling-video/3.0/omni/pro/reference-to-video/docs

## Facts

- Provider: KwaiVGI
- Type: Video model
- Model ID: `kwaivgi/kling-video/3.0/omni/pro/reference-to-video`
- Price: From $0.39 per run (30% off list price)
- Capabilities: reference to video
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kwaivgi/kling-video/3.0/omni/pro/reference-to-video",
  "images": [
    "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_images_0.png",
    "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_images_1.png"
  ],
  "prompt": "Take @Image1 as the start frame. Start with a high-angle satellite view of the ancient greenhouse ruin surrounded by nature. The camera swoops down and flies inside the building, revealing the character from @Element1 standing in the sun-drenched center. The camera then seamlessly transitions into a smooth 180-degree orbit around the character, moving to the back view. As the open backpack comes into focus, the camera continues to push forward, zooming deep inside the bag to reveal the glowing stone from @Element2 nestled inside. Cinematic lighting, hopeful atmosphere, 35mm lens. Make sure to keep it as the style of @Image2.",
  "duration": 5,
  "elements": [
    {
      "frontal_image_url": "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_0.png",
      "reference_image_urls": [
        "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_1.png",
        "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_2.png"
      ]
    },
    {
      "frontal_image_url": "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_3.png",
      "reference_image_urls": [
        "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_4.png"
      ]
    }
  ],
  "aspect_ratio": "16:9"
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call KwaiVGI Kling 3.0 Omni Pro Reference to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "kwaivgi/kling-video/3.0/omni/pro/reference-to-video" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate KwaiVGI account?

No. One SandBase API key and balance gives you access to KwaiVGI Kling 3.0 Omni Pro Reference to Video and the other models in the catalog; you do not need to sign up with KwaiVGI separately.

## README

### Kling 3.0 Omni Pro Reference to Video

Kling 3.0 Omni Pro reference-to-video: cast characters and objects from reference images (and optional elements) into a new 3–10 second scene.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Up to 2,500 characters. |
| `images` | image URL[], required | — | Reference images, referred to as @Image1, @Image2, … in the prompt. |
| `duration` | 3–10 | 5 | Output length in seconds. |
| `elements` | object[] | — | Optional character or object elements to keep consistent. |
| `aspect_ratio` | `16:9` / `9:16` / `1:1` | `16:9` | Output frame shape. |

#### Billing

$0.112 per output second.

| Output | Price |
|---|---|
| 3s | $0.336 |
| 5s (default) | $0.56 |
| 10s | $1.12 |

Failed runs are not charged.

#### Prompting

- Refer to each reference as @Image1, @Image2 and give it a role.

#### Limits

- Clips are 3–10 seconds.

#### Also on SandBase

Other Kling 3.0 Omni endpoints: `kwaivgi/kling-video/3.0/omni/pro/image-to-video`, `kwaivgi/kling-video/3.0/omni/pro/video-to-video/edit`.