kwaivgi/kling-video/v3/standard/image-to-video

Name: Kling Video V3 Standard
Author: KwaiVGI

Kling Video V3 Standard by KwaiVGI - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.

Input

Prompt(string)

Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both.

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

URL of the image to be used for the video

This field is required.

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

URL of the image to be used for the end of the video

Duration(integer)

The duration of the generated video in seconds Allowed values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.

Generate Audio(boolean)

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.

Shot Type(string)

The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure. Allowed values: customize, intelligent.

Multi Prompt(array)

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.

POSThttps://api.sandbase.ai/v1/run

Model IDkwaivgi/kling-video/v3/standard/image-to-video

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

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, or timeout
Retrieve — Read outputs from 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/standard/image-to-video",
  "image": "https://storage.googleapis.com/falserverless/example_inputs/kling-v3/standard-i2v/start_image.png",
  "prompt": "Camera slowly orbits around the vase. Soft light shifts across the ceramic surface. The pampas grass sways gently. Shadows move elegantly. Smooth continuous motion, premium feel.",
  "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"

← Back to Kling Video V3 Standard

API README

Kling Video V3 Standard Image-to-Video

Kling Video V3 Standard 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 Standard 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 Standard image animation route. Movement is a model capability rather than a request parameter.
Improved visual quality. The V3 Standard image-to-video documentation identifies improved visual quality. The statement maps to this exact version, tier, and route.
Improved motion consistency. Motion consistency is also identified as improved for V3 Standard image-to-video. It is distinct from the route's fluid-motion positioning.

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
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 Standard tier for this image-led workflow.	Choose Pro when its exact tier capabilities are required.

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": "Camera slowly orbits around the vase while soft light shifts and the pampas grass sways gently.",
  "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

Kling Video V3 Standard Text-to-Video — Generate without an opening image.
Kling Video V3 Pro Image-to-Video — Compare the sibling tier.