Skip to main content
Endpoint: POST https://fal.run/fal-ai/kling-video/v2/master/image-to-video Endpoint ID: fal-ai/kling-video/v2/master/image-to-video

Try it in the Playground

Run this model interactively with your own prompts.

Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/kling-video/v2/master/image-to-video",
    arguments={
        "prompt": "slow-motion sequence captures the catastrophic implosion of a skyscraper, dust and debris billowing outwards in a chaotic ballet of destruction, while a haunting, orchestral score underscores the sheer power and finality of the event.",
        "image_url": "https://v3.fal.media/files/elephant/rkH-9qoXtXu3rAYTsx9V5_image.webp"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

Examples

A close-up reveals a woman’s delicate fingers gracefully holding a perfume bottle, its crystal facets catching the light, a slow, deliberate movement emphasizing the product’s luxurious quality; the scene is bathed in soft, warm lighting, creating an intimate and sensual atmosphere. Camera zoom out…
Under a vast, clear sky, a Shub-Niggurath shepherd in futuristic soldier gear and a shaved-sides haircut smiles and laughs faintly while casually posing near a cybernetics clinic set against a sandy, rocky landscape, a relaxed picnic spread laid out nearby.
A warm, golden light bathes a cozy bedroom where a fluffy Persian cat and a scruffy terrier sleep curled together on a plush bed, their gentle breaths creating a peaceful atmosphere; the scene unfolds in a slow, deliberate pace with the camera maintaining a steady position, focusing on the subtle mo…

Input Schema

prompt
string
required
image_url
string
required
URL of the image to be used for the video
duration
DurationEnum
default:"5"
The duration of the generated video in seconds Default value: "5"Possible values: 5, 10
negative_prompt
string
default:"blur, distort, and low quality"
Default value: "blur, distort, and low quality"
cfg_scale
float
default:"0.5"
The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt. Default value: 0.5Range: 0 to 1

Output Schema

video
File
required
The generated video

Input Example

{
  "prompt": "slow-motion sequence captures the catastrophic implosion of a skyscraper, dust and debris billowing outwards in a chaotic ballet of destruction, while a haunting, orchestral score underscores the sheer power and finality of the event.",
  "image_url": "https://v3.fal.media/files/elephant/rkH-9qoXtXu3rAYTsx9V5_image.webp",
  "duration": "5",
  "negative_prompt": "blur, distort, and low quality",
  "cfg_scale": 0.5
}

Output Example

{
  "video": {
    "url": "https://v3.fal.media/files/koala/VvGXP5xEhTR9ovGjpulJ7_output.mp4"
  }
}

Kling AI v2 Master - Professional Image-to-Video Generation

Transform static images into dynamic, fluid video content with Kling AI v2 Master. Built by Kuaishou and optimized for professional creative workflows, this advanced AI model generates high-quality video animations from single images with unprecedented control and natural motion.

Overview

Kling AI v2 Master excels at creating smooth, realistic video animations from still images. Whether you’re a content creator, marketing professional, or developer building video applications, this model delivers production-ready results through an intuitive API. As the premium tier offering, it provides superior motion fluidity and cinematic quality for professional-grade video creation.

Key Capabilities

Transform any still image into fluid video content with:
  • Natural motion patterns that respect physics and object relationships
  • Precise control over animation duration (5 or 10 seconds)
  • Consistent quality across diverse image types
  • Professional-grade cinematic output
  • Enhanced visual aesthetics and motion dynamics

Getting Started

Getting up and running with Kling AI is straightforward. First, install your preferred SDK: JavaScript/TypeScript:
npm install --save @fal-ai/client
Python:
pip install fal-client

Authentication

Configure your API credentials:
import { fal } from "@fal-ai/client";

fal.config({
  credentials: "YOUR_FAL_KEY_HERE"
});

Basic Usage

Here’s a simple example of generating a video from an image:
const result = await fal.subscribe("fal-ai/kling-video/v2/master/image-to-video", {
  input: {
    prompt: "slow-motion sequence captures the catastrophic implosion of a skyscraper",
    image_url: "https://example.com/source-image.jpg",
    duration: "5",
    aspect_ratio: "16:9",
    negative_prompt: "blur, distort, and low quality",
    cfg_scale: 0.5
  }
});

console.log(result.video.url);

API Parameters

  • prompt (required): Text description of the desired motion and scene
  • image_url (required): URL of the input image
  • duration: Video duration - “5” or “10” seconds
  • aspect_ratio: Output aspect ratio (e.g., “16:9”, “9:16”, “1:1”)
  • negative_prompt: Elements to avoid in the generation
  • cfg_scale: Classifier Free Guidance scale (default: 0.5)
  • static_mask_url: URL for static motion brush mask
  • dynamic_mask_url: URL for dynamic motion brush mask
  • special_fx: Special effects options
  • input_image_urls: Array of up to 4 images for multi-image generation

Advanced Features

The v2 Master model provides sophisticated controls for professional applications:

Motion Control

Adjust motion intensity and patterns through intuitive parameters. Fine-tune the balance between dramatic movement and natural flow to match your creative vision using cfg_scale and motion masks.

Quality Settings

Master tier delivers the highest quality output with enhanced detail and smoother motion, ideal for professional productions and cinematic content.

Format Options

Export to multiple video formats with control over resolution and aspect ratio to optimize for different distribution channels.

Queue Management

For asynchronous processing:
// Submit request
const { request_id } = await fal.queue.submit("fal-ai/kling-video/v2/master/image-to-video", {
  input: {
    prompt: "Your cinematic description",
    image_url: "your-image-url",
    duration: "10"
  }
});

// Check status
const status = await fal.queue.status("fal-ai/kling-video/v2/master/image-to-video", {
  requestId: request_id,
  logs: true
});

// Get result
const result = await fal.queue.result("fal-ai/kling-video/v2/master/image-to-video", {
  requestId: request_id
});

Best Practices

For optimal results: Start with high-quality source images. The model performs best with clear, well-lit images at high resolution. Test different cfg_scale values. Begin with moderate settings (0.5) and adjust based on your content needs. Consider your target platform. Adjust aspect ratio and duration settings to match your distribution requirements while maintaining quality.

Technical Support

Our comprehensive documentation covers advanced usage scenarios, parameter tuning, and troubleshooting. For additional support:
  • Visit our documentation portal for detailed guides
  • Join our developer community for peer support
  • Contact our technical team for enterprise assistance

Pricing and Usage

Premium pricing for professional quality:
  • 5-second video: $1.40
  • Additional seconds: $0.28 per second
  • 10-second video: $2.80
View detailed pricing or contact sales for enterprise solutions.

Model Variants

Kling offers multiple quality tiers:
  • Master: This model - Premium quality for professional use
  • Standard: fal-ai/kling-video/v2/standard/image-to-video - Cost-efficient option
  • v2.1 Versions: Latest iteration with additional improvements

Support and Resources

Ready to Create Cinematic Videos?

Get started with Kling AI v2 Master today and experience professional-grade video generation capabilities. Create your API key at fal.ai and transform your images into stunning, cinematic videos.

Limitations

  • duration restricted to: 5, 10
  • cfg_scale range: 0 to 1
  • aspect_ratio restricted to: 16:9, 9:16, 1:1