kwaivgi/kling-video/v3/4k/text-to-video
Kling Video V3 4k is KwaiVGI's text-to-video AI model. Turn written scripts and prompts into professional-quality video clips with realistic motion, lighting, and scene composition.
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runkwaivgi/kling-video/v3/4k/text-to-videoInput Schema
6 parameters · 1 required · 5 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both. · Max length: 2500 |
duration | integer | Optional | The duration of the generated video in seconds · Options: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 · Default: 5 3456789101112131415 |
shot_type | string | Optional | The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure. · Options: customize, intelligent · Default: "customize" customizeintelligent |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 16:9, 9:16, 1:1 16:99:161:1 |
multi_prompt | object[] | Optional | List of prompts for multi-shot video generation. If provided, overrides the single prompt and divides the video into multiple shots with specified prompts and durations. |
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 |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "kwaivgi/kling-video/v3/4k/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",
"generate_audio": true
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Kling Video V3 4K Text-to-Video
Kling Video V3 4K Text-to-Video converts a written creative brief into a rendered video clip. The endpoint is the text-first option in the Kling Video V3 4K model family, so no image upload is needed to begin generation.
The workflow keeps narrative direction and video generation in one request. Teams can move from a script-like description to a downloadable result while choosing the framing and run time appropriate to the intended sequence.
Highlights
Native professional-grade 4K. Produces professional-quality 4K video directly, preserving the resolution expected for premium campaign, cinematic, and large-screen delivery.
One-step 4K generation. Creates the high-resolution result in a single generation step, so the workflow does not depend on a separate upscale pass.
Cinema-grade clarity. Maintains cinematic visual clarity in the generated 4K frame, helping fine scene detail remain legible at final delivery resolution.
Multi-shot composition. Builds a sequenced clip from distinct per-shot prompts and durations; creators can define each cut with customize or let intelligent plan the shot structure.
Pricing
| Duration | Price |
|---|---|
| 3 seconds | $1.260 |
| 4 seconds | $1.680 |
| 5 seconds | $2.100 |
| 6 seconds | $2.520 |
| 7 seconds | $2.940 |
| 8 seconds | $3.360 |
| 9 seconds | $3.780 |
| 10 seconds | $4.200 |
| 11 seconds | $4.620 |
| 12 seconds | $5.040 |
| 13 seconds | $5.460 |
| 14 seconds | $5.880 |
| 15 seconds | $6.300 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The scene should be created entirely from written direction | A source image must anchor the opening frame |
| A managed asynchronous result is suitable for the production pipeline | A synchronous, interactive editor is essential |
| The documented controls cover the required duration, framing, or format | The project needs controls outside this endpoint's schema |
| Creative iteration benefits from a repeatable request structure | Exact deterministic pixels, frames, geometry, or samples are mandatory |
| A finished downloadable media asset is the desired deliverable | Editable source layers or a native project file are required |
Prompt Guide
For generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.
{
"aspect_ratio": "16:9",
"duration": 5,
"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."
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | kwaivgi/kling-video/v3/4k/text-to-video |
| Inputs | aspect_ratio, duration, generate_audio, multi_prompt, prompt, shot_type |
| Required inputs | prompt |
| Output fields | content_type, url |
| Execution | Async (submit, then poll for result) |
| Duration | 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 |
| Aspect Ratio | 16:9 / 9:16 / 1:1 |
Related Models
kwaivgi/kling-video/v3/4k/image-to-video— Compare a nearby route in the same local model family.kwaivgi/kling-video/v3— Compare a nearby route in the same local model family.kwaivgi/kling-video/v3/pro/image-to-video— Compare a nearby route in the same local model family.