> ## Documentation Index > Fetch the complete documentation index at: https://fal.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Kling Video V2 Master API > API reference for Kling Video V2 Master. Generate video clips from your images using Kling 2.0 Master **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` Run this model interactively with your own prompts. ### Quick Start ```python title="Python" theme={null} 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) ``` ```javascript title="JavaScript" theme={null} import { fal } from "@fal-ai/client"; 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, 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" }, logs: true, onQueueUpdate: (update) => { if (update.status === "IN_PROGRESS") { update.logs.map((log) => log.message).forEach(console.log); } }, }); console.log(result.data); console.log(result.requestId); ``` ```bash title="cURL" theme={null} curl --request POST \ --url https://fal.run/fal-ai/kling-video/v2/master/image-to-video \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "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" }' ``` ## 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... **Endpoint:** `POST https://fal.run/fal-ai/kling-video/v2/master/text-to-video` **Endpoint ID:** `fal-ai/kling-video/v2/master/text-to-video` Run this model interactively with your own prompts. ### Quick Start ```python title="Python" theme={null} 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/text-to-video", arguments={ "prompt": "A slow-motion drone shot descending from above a maze of neon-lit Tokyo alleyways at night during heavy rainfall. The camera gradually focuses on a lone figure in a luminescent white raincoat standing perfectly still amid the bustling crowd, all carrying black umbrellas. As the camera continues its downward journey, we see the raindrops creating rippling patterns on puddles that reflect the kaleidoscope of colors from the surrounding signs, creating a mirror world beneath the city." }, with_logs=True, on_queue_update=on_queue_update, ) print(result) ``` ```javascript title="JavaScript" theme={null} import { fal } from "@fal-ai/client"; const result = await fal.subscribe("fal-ai/kling-video/v2/master/text-to-video", { input: { prompt: "A slow-motion drone shot descending from above a maze of neon-lit Tokyo alleyways at night during heavy rainfall. The camera gradually focuses on a lone figure in a luminescent white raincoat standing perfectly still amid the bustling crowd, all carrying black umbrellas. As the camera continues its downward journey, we see the raindrops creating rippling patterns on puddles that reflect the kaleidoscope of colors from the surrounding signs, creating a mirror world beneath the city." }, logs: true, onQueueUpdate: (update) => { if (update.status === "IN_PROGRESS") { update.logs.map((log) => log.message).forEach(console.log); } }, }); console.log(result.data); console.log(result.requestId); ``` ```bash title="cURL" theme={null} curl --request POST \ --url https://fal.run/fal-ai/kling-video/v2/master/text-to-video \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "prompt": "A slow-motion drone shot descending from above a maze of neon-lit Tokyo alleyways at night during heavy rainfall. The camera gradually focuses on a lone figure in a luminescent white raincoat standing perfectly still amid the bustling crowd, all carrying black umbrellas. As the camera continues its downward journey, we see the raindrops creating rippling patterns on puddles that reflect the kaleidoscope of colors from the surrounding signs, creating a mirror world beneath the city." }' ``` ### Input Schema The duration of the generated video in seconds Default value: `"5"` Possible values: `5`, `10` The aspect ratio of the generated video frame Default value: `"16:9"` Possible values: `16:9`, `9:16`, `1:1` Default value: `"blur, distort, and low quality"` The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt. Default value: `0.5` Range: `0` to `1` ### Output Schema The generated video ### Input Example ```json theme={null} { "prompt": "A slow-motion drone shot descending from above a maze of neon-lit Tokyo alleyways at night during heavy rainfall. The camera gradually focuses on a lone figure in a luminescent white raincoat standing perfectly still amid the bustling crowd, all carrying black umbrellas. As the camera continues its downward journey, we see the raindrops creating rippling patterns on puddles that reflect the kaleidoscope of colors from the surrounding signs, creating a mirror world beneath the city.", "duration": "5", "aspect_ratio": "16:9", "negative_prompt": "blur, distort, and low quality", "cfg_scale": 0.5 } ``` ### Output Example ```json theme={null} { "video": { "url": "https://v3.fal.media/files/rabbit/5fu6OSZdvV825r2s_c0S8_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: ```bash theme={null} npm install --save @fal-ai/client ``` Python: ```bash theme={null} pip install fal-client ``` #### Authentication Configure your API credentials: ```typescript theme={null} 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: ```typescript theme={null} 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: ```typescript theme={null} // 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](https://fal.ai/pricing) or [contact sales](mailto:support@fal.ai) 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 * API Documentation: [fal.ai/models/fal-ai/kling-video/v2/master/image-to-video/api](https://fal.ai/models/fal-ai/kling-video/v2/master/image-to-video/api) * Discord Community: [discord.com/invite/fal-ai](https://discord.com/invite/fal-ai) * Support: [support@fal.ai](mailto:support@fal.ai) ### 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](https://fal.ai) and transform your images into stunning, cinematic videos. ## Related * [Kling 2.0 Master](/model-api-reference/video-generation-api/kling-2.0-master) — Video Generation ## Limitations * `duration` restricted to: `5`, `10` * `cfg_scale` range: 0 to 1 * `aspect_ratio` restricted to: `16:9`, `9:16`, `1:1`