kwaivgi/kling-video/3.0/omni/pro/image-to-video
Kling Video Omni 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.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
PNG, JPEG, WebP, or GIF · 20 MiB maximum
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/3.0/omni/pro/image-to-videoInput Schema
4 parameters · 2 required · 2 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | Image to use as the first frame of the video. Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s |
prompt | string | Required | Use @Image1 to reference the start frame, @Image2 to reference the end frame. · Max length: 2500 |
duration | integer | Optional | Video duration in seconds. · Options: 3, 4, 5, 6, 7, 8, 9, 10 · Default: 5 345678910 |
end_image | string | Optional | Image to use as the last frame of the video. |
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/3.0/omni/pro/image-to-video",
"image": "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/image-to-video/input_image_0.png",
"prompt": "Create a magical timelapse transition. The snow melts rapidly to reveal green grass, and the tree branches burst into bloom with pink flowers in real-time. The lighting shifts from cold winter light to warm spring sunshine. The camera pushes in slowly towards the tree. Disney-style magical transformation, cinematic, 8k.",
"duration": 5,
"end_image": "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/image-to-video/input_end_image_1.png"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Kling 3.0 Omni Pro Image to Video
Kling 3.0 Omni Pro Image to Video animates a required starting image into a directed video while preserving the visual identity, composition, and key details established by that frame. Add an optional ending image when the shot must arrive at a specific final composition, then use the prompt to describe the action, transformation, camera movement, lighting progression, and narrative connection between the two frames.
Built on Kling VIDEO 3.0 Omni's unified multimodal foundation, the model is designed for stronger semantic response, narrative control, and visual consistency across changing scenes. This route focuses that capability into a streamlined first-frame or first-and-last-frame workflow, making it practical for cinematic transitions, character and product animation, environmental transformations, and shots whose opening and ending beats must be planned in advance.
Highlights
- Directed start-to-end transitions. Anchor the opening with
imageand optionally define the destination withend_image, giving the model clear visual boundaries for the shot. - Stronger subject consistency. Preserves recognizable character, object, and scene features as movement and camera perspective evolve across the generated sequence.
- Narrative and semantic control. Responds to detailed instructions for staged action, scene progression, camera behavior, atmosphere, and visual transformation rather than applying generic motion.
- Omni audiovisual foundation. Kling VIDEO 3.0 Omni is built for native audio-visual creation and coherent multi-shot storytelling; this API route packages its Pro image-to-video workflow around a prompt and frame controls.
Pricing
Billing is $0.112 per selected output second. The available durations and resulting request prices are listed below.
| Duration | Price per request |
|---|---|
| 3 seconds | $0.336 |
| 4 seconds | $0.448 |
| 5 seconds | $0.560 |
| 6 seconds | $0.672 |
| 7 seconds | $0.784 |
| 8 seconds | $0.896 |
| 9 seconds | $1.008 |
| 10 seconds | $1.120 |
When to Use
| Use case | Why this model fits |
|---|---|
| Character or product animation | Turn a designed still into controlled motion while keeping its defining visual features recognizable. |
| First-to-last-frame transitions | Supply both endpoints for a transformation, reveal, pose change, or planned change in composition. |
| Seasonal and environmental changes | Direct weather, time-of-day, material, or landscape progression from one visual state to another. |
| Cinematic camera moves | Describe pushes, pulls, orbits, tracking moves, reframing, and lighting changes around the starting composition. |
| Short narrative beats | Build a focused 3–10 second action with a clear beginning, progression, and final visual payoff. |
Prompt Guide
Refer to the starting frame as @Image1 and the optional ending frame as @Image2. First state what must remain consistent, then describe the movement and transformation in chronological order. Add camera direction, subject motion, environmental changes, lighting, pacing, and the desired finish. When an end frame is supplied, explain how the action should naturally bridge the two images instead of merely describing them separately.
{
"prompt": "Keep the ancient tree and central composition from @Image1 recognizable. Begin in cold winter light as loose snow falls from the branches. The camera slowly pushes forward while the snow melts, green grass emerges, and pink blossoms open in a flowing magical time-lapse. Warm spring sunlight gradually replaces the blue light. Finish naturally on the fully blooming landscape shown in @Image2, with smooth cinematic motion and realistic depth.",
"image": "https://example.com/winter-start.png",
"end_image": "https://example.com/spring-end.png",
"duration": 8
}
Technical Specs
| Property | Details |
|---|---|
| Model ID | kwaivgi/kling-video/3.0/omni/pro/image-to-video |
| Required inputs | prompt, image |
| Start frame | URL in image; maximum 10 MB, minimum 300 × 300 px, aspect ratio from 0.40 to 2.50 |
| End frame | Optional URL in end_image |
| Prompt length | Up to 2,500 characters |
| Frame references | Use @Image1 for the start frame and @Image2 for the end frame |
| Output duration | 3–10 whole seconds; default 5 |
| Output | Downloadable MP4 video URL with optional content type |
| Execution | Asynchronous |
Related Models
kwaivgi/kling-video/v3/pro/image-to-video— compare with the standard Kling 3.0 Pro image-animation route.kwaivgi/kling-video/3.0/omni/pro/text-to-video— create an Omni Pro video directly from text.kwaivgi/kling-video/o3/pro/image-to-video— use the O3 Pro image-to-video workflow with extended controls.