kwaivgi/kling-video/v3/pro/image-to-video
Kling Video V3 Pro is KwaiVGI's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output.
Input
Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
URL of the image to be used for the video
This field is required.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
URL of the image to be used for the end of the video
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, divides the video into multiple shots.
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/pro/image-to-video01
Input Schema
7 parameters · 2 required · 5 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | URL of the image to be used for the video |
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 |
end_image | string | Optional | URL of the image to be used for the end of the video |
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 |
multi_prompt | object[] | Optional | List of prompts for multi-shot video generation. If provided, divides the video into multiple shots. |
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/pro/image-to-video",
"image": "https://storage.googleapis.com/falserverless/example_inputs/kling-v3/pro-i2v/start_image.png",
"prompt": "The craftsman slowly examines the bowl, turning it gently in his weathered hands. His eyes reflect years of wisdom. Subtle smile forms on his face. Dust particles drift in warm light. Breathing motion, blinking eyes.",
"duration": 12,
"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 Pro Image-to-Video
Kling Video V3 Pro animates a supplied opening image from a written direction. The image fixes the first frame while the prompt describes action, camera behavior, and changes over time. An optional end image can guide the final frame.
The route produces clips from 3 to 15 seconds and returns a video URL. A request can select custom or intelligent shot structure, and native audio is enabled by default. The opening image determines the frame shape because this route has no separate aspect-ratio field.
Highlights
- Cinematic visual quality. The exact Pro image-to-video route is documented for cinematic visuals. This is the route's stated visual positioning.
- Fluid motion. Fluid motion is explicitly identified for this Pro image animation route. Movement is a model capability rather than a request parameter.
- Native audio generation. The exact route is documented to generate native audio with video. Audio belongs to the generated result rather than a separate post-process.
- Strong subject and text consistency. The exact Pro page identifies strong subject and text consistency. This capability applies while the opening image is animated.
Pricing
| Duration | Price |
|---|---|
| 3 seconds | $0.504 |
| 4 seconds | $0.672 |
| 5 seconds | $0.840 |
| 6 seconds | $1.008 |
| 7 seconds | $1.176 |
| 8 seconds | $1.344 |
| 9 seconds | $1.512 |
| 10 seconds | $1.680 |
| 11 seconds | $1.848 |
| 12 seconds | $2.016 |
| 13 seconds | $2.184 |
| 14 seconds | $2.352 |
| 15 seconds | $2.520 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| Add movement to an existing product or character still. | Begin without any opening image; use text-to-video. |
| Direct a camera move around the composition in the first frame. | Select frame shape independently of the supplied image. |
| Guide a transition toward a supplied final frame. | Require a clip longer than 15 seconds in one request. |
| Produce a short scene with generated sound enabled. | Require voice behavior outside the documented language handling. |
| Use the Pro tier for this image-led workflow. | Prefer the lower local price of the Standard sibling. |
Prompt Guide
Describe how the visible scene should move. Keep the request to the required image and prompt fields first, then add duration, audio, end-frame, or shot settings only when needed.
Subject action: [movement over time]
Camera: [framing and camera path]
Environment: [light, wind, particles, background movement]
Timing: [pace and progression]
Audio: [ambience, effects, or speech when enabled]
Final state: [arrival at the optional end image]
{
"image": "<start-image-url>",
"prompt": "The craftsman slowly examines the bowl while warm light shifts and dust drifts through the air.",
"duration": 5,
"generate_audio": true
}
Technical Specs
| Spec | Value |
|---|---|
| Required inputs | image, prompt |
| Prompt length | Up to 2,500 characters |
| Duration | 3–15 seconds; default 5 |
| Frame guidance | Required image; optional end_image |
| 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 Pro Text-to-Video — Generate without an opening image.
- Kling Video V3 Standard Image-to-Video — Compare the sibling tier.