# KwaiVGI Kling V3 Pro Text to Video API

> Kling V3 Pro Text to Video by Kuaishou turns a text prompt into a 3-15 second 1080p video with optional native audio.

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

## Facts

- Provider: KwaiVGI
- Type: Video model
- Model ID: `kwaivgi/kling-video/v3/pro/text-to-video`
- Price: From $0.59 per run (30% off list price)
- Capabilities: text 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/v3/pro/text-to-video",
  "prompt": "Close-up of glowing fireflies dancing in a dark forest at twilight. Soft bioluminescent particles float through the air. Shallow depth of field, bokeh lights in background. Magical atmosphere, gentle movement.",
  "duration": 5,
  "shot_type": "customize",
  "aspect_ratio": "16:9",
  "generate_audio": true
}'
```

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 V3 Pro Text to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "kwaivgi/kling-video/v3/pro/text-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 V3 Pro Text to Video and the other models in the catalog; you do not need to sign up with KwaiVGI separately.

## README

### Kling V3 Pro Text to Video

Kling V3 Pro text-to-video: write a scene and get back a 3–15 second clip, with native audio and multi-shot control.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Up to 2,500 characters. |
| `aspect_ratio` | `16:9` / `9:16` / `1:1` | `16:9` | Output frame shape. |
| `duration` | 3–15 | 5 | Output length in seconds. |
| `generate_audio` | boolean | true | Generate native audio with the clip. |
| `shot_type` | `customize` / `intelligent` | `customize` | `customize` follows your `multi_prompt` shot list; `intelligent` lets the model plan the cuts. |
| `multi_prompt` | object[] | — | Optional list of shots, each with its own prompt and duration. |

#### Billing

You pay for output seconds: $0.168 with audio (the default) and $0.112 without.

| Output | With audio | Without audio |
|---|---|---|
| 3s | $0.504 | $0.336 |
| 5s (default) | $0.84 | $0.56 |
| 10s | $1.68 | $1.12 |
| 15s | $2.52 | $1.68 |

Failed runs are not charged.

#### Prompting

- Describe subject, action, camera move, and light in order.
- For several shots, use `multi_prompt` with one entry per shot.

#### Limits

- Clips are 3–15 seconds.

#### Also on SandBase

Other Kling V3 Pro endpoints and tiers: `kwaivgi/kling-video/v3/pro/image-to-video`, `kwaivgi/kling-video/v3/pro/motion-control`, `kwaivgi/kling-video/v3/standard/text-to-video`, `kwaivgi/kling-video/v3/4k/text-to-video`.
