kwaivgi/kling-video/v3/standard/text-to-video
Kling Video V3 Standard 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.
Input
Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both.
The aspect ratio of the generated image. Allowed values: 16:9, 9:16, 1:1.
The duration of the generated video in seconds Allowed values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.
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.
The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure. Allowed values: customize, intelligent.
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.
Idle
Example output — click Run to generate your own
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
kwaivgi/kling-video/v3/standard/text-to-video01
Input 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 |
02
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
03
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/standard/text-to-video",
"prompt": "Cinematic drone shot flying through ancient stone ruins covered in moss and vines at golden hour. Camera starts low, rises through crumbling archways, revealing a vast misty valley beyond. Volumetric light rays pierce through gaps in the stone. Epic scale, photorealistic, 8K quality.",
"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 Standard Text-to-Video
Kling Video V3 Standard generates video directly from a written scene. The prompt describes the subject, action, camera, light, atmosphere, and sound without requiring an opening image. Landscape, portrait, and square frame shapes are available.
The route produces clips from 3 to 15 seconds and returns a video URL. Native audio is enabled by default, with documented language handling in the local contract. Custom and intelligent shot structure are exposed as request settings.
Highlights
- Cinematic visual quality. The exact Standard text-to-video route is documented for cinematic visuals. This is the route's stated visual positioning.
- Fluid motion. Fluid motion is explicitly identified for Standard text-to-video. Movement is generated from the written scene direction.
- Improved visual quality. V3 Standard text-to-video documentation identifies improved visual quality. The statement is scoped to this exact version, tier, and route.
- Improved motion consistency. Motion consistency is also identified as improved for V3 Standard text-to-video. It describes the generated motion rather than a schema control.
Pricing
| Duration | Price |
|---|---|
| 3 seconds | $0.378 |
| 4 seconds | $0.504 |
| 5 seconds | $0.630 |
| 6 seconds | $0.756 |
| 7 seconds | $0.882 |
| 8 seconds | $1.008 |
| 9 seconds | $1.134 |
| 10 seconds | $1.260 |
| 11 seconds | $1.386 |
| 12 seconds | $1.512 |
| 13 seconds | $1.638 |
| 14 seconds | $1.764 |
| 15 seconds | $1.890 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| Turn a written scene into a short video without an image input. | Preserve a specific opening composition; use image-to-video. |
| Describe action and camera movement in one continuous prompt. | Require a clip longer than 15 seconds in one request. |
| Deliver landscape, vertical, or square video. | Require an aspect ratio outside the documented set. |
| Include generated ambience, effects, or speech. | Require voice behavior outside the documented language handling. |
| Use the Standard tier for this text-led workflow. | Choose Pro when its exact tier capabilities are required. |
Prompt Guide
Write one continuous scene in temporal order. Start with the required prompt; add duration, aspect ratio, audio, or shot settings only when the request needs them.
Scene: [setting, time, atmosphere]
Subject: [appearance and action]
Camera: [framing and movement]
Lighting: [direction and change]
Motion: [subject and environment]
Audio: [ambience, effects, or speech when enabled]
{
"prompt": "Cinematic drone shot through ancient stone ruins at golden hour. The camera rises through archways and reveals a misty valley.",
"duration": 5,
"aspect_ratio": "16:9",
"generate_audio": true
}
Technical Specs
| Spec | Value |
|---|---|
| Required input | prompt |
| Prompt length | Up to 2,500 characters |
| Duration | 3–15 seconds; default 5 |
| Aspect ratios | 16:9, 9:16, 1:1 |
| Shot types | customize, intelligent |
| Multi-prompt field | Exposed locally, but prompt remains required by the request contract |
| Native audio | Optional; default enabled |
| Output | Video URL with optional file metadata |
Related
- Kling Video V3 Standard Image-to-Video — Animate a supplied opening image.
- Kling Video V3 Pro Text-to-Video — Compare the sibling tier.