# KwaiVGI Kling V4 Flash Reference to Video API

> Kling V4 Flash Reference to Video by Kuaishou generates a 3-20 second 720p video that keeps characters, objects and motion from reference images and videos.

Source: https://www.sandbase.ai/models/kwaivgi/kling-video/v4/flash/reference-to-video
API reference: https://www.sandbase.ai/models/kwaivgi/kling-video/v4/flash/reference-to-video#api

## Facts

- Provider: KwaiVGI
- Type: Video model
- Model ID: `kwaivgi/kling-video/v4/flash/reference-to-video`
- Price: From $0.47 per run
- 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/v4/flash/reference-to-video",
  "prompt": "@Element1 and @Element2 are having dinner at the table in @Image1",
  "duration": 5
}'
```

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 V4 Flash Reference to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "kwaivgi/kling-video/v4/flash/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 V4 Flash Reference to Video and the other models in the catalog; you do not need to sign up with KwaiVGI separately.

## README

### Kling V4 Flash Reference to Video
Kling V4 Flash reference-to-video keeps characters, objects and motion from reference images and videos in a new 3–20 second 720p clip.
#### Fields
| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Refer to inputs as `@Image1`, `@Video1`, … |
| `images` | image URL[] | — | Up to 10 reference images. |
| `videos` | video URL[] | — | Up to 5 reference videos, 3–20s each, 20s combined. |
| `aspect_ratio` | `21:9` / `16:9` / `9:16` / `1:1` | — | Leave empty to follow the references. |
| `duration` | 3–20 | 5 | Output length in seconds. |
#### Billing
Without reference videos: $0.094 per output second.
With reference videos: $0.063 per second of output plus input, where the input side counts at least as long as the output. The quote before submission assumes 20 seconds of reference video when the length cannot be read.
| Request | Price |
|---|---|
| 5s, images only (default) | $0.47 |
| 10s, images only | $0.94 |
| 5s, 8s reference video | $0.819 |
| 10s, 4s reference video | $1.26 |
Failed runs are not charged.
#### Prompting
- Name each reference in the prompt, e.g. "@Image1 walks into the scene from @Video1".
#### Limits
- Output is 720p only; clips are 3–20 seconds; reference videos 3–20 seconds.
- Custom voices (`voice_ids`) are only on `kwaivgi/kling-video/v4/reference-to-video`.
#### Also on SandBase
Other Kling V4 Flash endpoints: `kwaivgi/kling-video/v4/flash/text-to-video`, `kwaivgi/kling-video/v4/flash/image-to-video`, `kwaivgi/kling-video/v4/flash/reference-to-video`, `kwaivgi/kling-video/v4/flash/video-edit`. For 1080p or clips up to 30 seconds, use Kling V4 (`kwaivgi/kling-video/v4/text-to-video` and its siblings).
