Kling Video V2.1 Master API

Image To Video
Text To Video

Endpoint: POST https://fal.run/fal-ai/kling-video/v2.1/master/image-to-video Endpoint ID: fal-ai/kling-video/v2.1/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.1/master/image-to-video",
    arguments={
        "prompt": "Sunlight dapples through budding branches, illuminating a vibrant tapestry of greens and browns as a pair of robins meticulously weave twigs and mud into a cradle of life, their tiny forms a whirlwind of activity against a backdrop of blossoming spring.  The scene unfolds with a gentle, observational pace, allowing the viewer to fully appreciate the intricate details of nest construction, the soft textures of downy feathers contrasted against the rough bark of the branches, the delicate balance of strength and fragility in their creation.",
        "image_url": "https://v3.fal.media/files/zebra/9Nrm22YyLojSTPJbZYNhh_image.webp"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/kling-video/v2.1/master/image-to-video", {
  input: {
      prompt: "Sunlight dapples through budding branches, illuminating a vibrant tapestry of greens and browns as a pair of robins meticulously weave twigs and mud into a cradle of life, their tiny forms a whirlwind of activity against a backdrop of blossoming spring.  The scene unfolds with a gentle, observational pace, allowing the viewer to fully appreciate the intricate details of nest construction, the soft textures of downy feathers contrasted against the rough bark of the branches, the delicate balance of strength and fragility in their creation.",
      image_url: "https://v3.fal.media/files/zebra/9Nrm22YyLojSTPJbZYNhh_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);

curl --request POST \
  --url https://fal.run/fal-ai/kling-video/v2.1/master/image-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "Sunlight dapples through budding branches, illuminating a vibrant tapestry of greens and browns as a pair of robins meticulously weave twigs and mud into a cradle of life, their tiny forms a whirlwind of activity against a backdrop of blossoming spring.  The scene unfolds with a gentle, observational pace, allowing the viewer to fully appreciate the intricate details of nest construction, the soft textures of downy feathers contrasted against the rough bark of the branches, the delicate balance of strength and fragility in their creation.",
  "image_url": "https://v3.fal.media/files/zebra/9Nrm22YyLojSTPJbZYNhh_image.webp"
}'

Examples

Sunlight streams through the window, illuminating the ancient bonsai tree and the gardener’s weathered hands as they delicately prune a wayward branch, the soft rustle of shears a counterpoint to the quiet intensity of the moment. The close-up reveals the intricate texture of the bark, the deep gre…

Bathed in the warm glow of a single, strategically placed lamp, the jeweler’s weathered hands delicately cradle a fiery opal, its iridescent depths shimmering like a captured sunset; each careful turn reveals new constellations of color, while the close-up shot emphasizes the stone’s alluring textur…

Swirls of ivory frosting, smooth as porcelain, rise and fall across a towering six-tiered cake, their delicate peaks catching the warm light, a symphony of creamy white against the rich mahogany of the cake stand. Each delicate floral arrangement, painstakingly crafted from sugar paste, adds a burs…

Input Schema

string

required

string

required

URL of the image to be used for the video

DurationEnum

default:"5"

The duration of the generated video in seconds Default value: "5"Possible values: 5, 10

string

default:"blur, distort, and low quality"

Default value: "blur, distort, and low quality"

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

File

required

The generated video

Input Example

{
  "prompt": "Sunlight dapples through budding branches, illuminating a vibrant tapestry of greens and browns as a pair of robins meticulously weave twigs and mud into a cradle of life, their tiny forms a whirlwind of activity against a backdrop of blossoming spring.  The scene unfolds with a gentle, observational pace, allowing the viewer to fully appreciate the intricate details of nest construction, the soft textures of downy feathers contrasted against the rough bark of the branches, the delicate balance of strength and fragility in their creation.",
  "image_url": "https://v3.fal.media/files/zebra/9Nrm22YyLojSTPJbZYNhh_image.webp",
  "duration": "5",
  "negative_prompt": "blur, distort, and low quality",
  "cfg_scale": 0.5
}

Output Example

{
  "video": {
    "url": "https://v3.fal.media/files/rabbit/YuUWKFq508zzWIiQ0i2vt_output.mp4"
  }
}

Endpoint: POST https://fal.run/fal-ai/kling-video/v2.1/master/text-to-video Endpoint ID: fal-ai/kling-video/v2.1/master/text-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.1/master/text-to-video",
    arguments={
        "prompt": "Warm, earthy tones bathe the scene as the potter's hands, rough and calloused, coax a shapeless lump of clay into a vessel of elegant curves, the slow, deliberate movements highlighted by the subtle shifting light; the clay's cool, damp texture contrasts sharply with the warmth of the potter's touch, creating a captivating interplay between material and maker."
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/kling-video/v2.1/master/text-to-video", {
  input: {
      prompt: "Warm, earthy tones bathe the scene as the potter's hands, rough and calloused, coax a shapeless lump of clay into a vessel of elegant curves, the slow, deliberate movements highlighted by the subtle shifting light; the clay's cool, damp texture contrasts sharply with the warmth of the potter's touch, creating a captivating interplay between material and maker."
    },
  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);

curl --request POST \
  --url https://fal.run/fal-ai/kling-video/v2.1/master/text-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "Warm, earthy tones bathe the scene as the potter'\''s hands, rough and calloused, coax a shapeless lump of clay into a vessel of elegant curves, the slow, deliberate movements highlighted by the subtle shifting light; the clay'\''s cool, damp texture contrasts sharply with the warmth of the potter'\''s touch, creating a captivating interplay between material and maker."
}'

Examples

Golden sunlight bathes the bustling street market, illuminating the vendor’s deft hands as they knead vibrant dough, the flour dusting the air like a soft, ethereal snow; the sizzle of the seasoned meat, a rhythmic counterpoint to the chatter of the crowd, creates a symphony of sights and sounds, c…

A breathtaking vista unfolds as the camera captures the inky blackness of the night sky mirroring the deep indigo of the ocean, where waves, edged with an ethereal, electric blue glow, crash gently against the shore, their phosphorescent foam leaving trails of shimmering light like liquid stardust.

Molten rivers of incandescent orange and crimson lava, sluggishly tracing paths of destruction across the scorched earth, illuminate the night with an infernal glow; their viscous surfaces, a tapestry of bubbling textures and crackling crusts, slowly creep onward, leaving behind a trail of solidifi…

Input Schema

string

required

DurationEnum

default:"5"

The duration of the generated video in seconds Default value: "5"Possible values: 5, 10

AspectRatioEnum

default:"16:9"

The aspect ratio of the generated video frame Default value: "16:9"Possible values: 16:9, 9:16, 1:1

string

default:"blur, distort, and low quality"

Default value: "blur, distort, and low quality"

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

File

required

The generated video

Input Example

{
  "prompt": "Warm, earthy tones bathe the scene as the potter's hands, rough and calloused, coax a shapeless lump of clay into a vessel of elegant curves, the slow, deliberate movements highlighted by the subtle shifting light; the clay's cool, damp texture contrasts sharply with the warmth of the potter's touch, creating a captivating interplay between material and maker.",
  "duration": "5",
  "aspect_ratio": "16:9",
  "negative_prompt": "blur, distort, and low quality",
  "cfg_scale": 0.5
}

Output Example

{
  "video": {
    "url": "https://v3.fal.media/files/lion/0wTlhR7GCXFI-_BZXGy99_output.mp4"
  }
}

Kling 2.1 (standard) — Video Generation
Kling 2.1 (pro) — Video Generation
Kling 2.1 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

Video Generation

Image Generation

Audio

Vision

3D

Kling Video V2.1 Master API

Try it in the Playground

Quick Start

Examples

Input Schema

Output Schema

Input Example

Output Example

Try it in the Playground

Quick Start

Examples

Input Schema

Output Schema

Input Example

Output Example

Limitations

Try it in the Playground

​Quick Start

​Examples

​Input Schema

​Output Schema

​Input Example

​Output Example

Try it in the Playground

​Quick Start

​Examples

​Input Schema

​Output Schema

​Input Example

​Output Example

​Related

​Limitations

Quick Start

Examples

Input Schema

Output Schema

Input Example

Output Example

Quick Start

Examples

Input Schema

Output Schema

Input Example

Output Example

Related

Limitations