Skip to main content
Endpoint: POST https://fal.run/fal-ai/kling-video/o3/standard/reference-to-video Endpoint ID: fal-ai/kling-video/o3/standard/reference-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/o3/standard/reference-to-video",
    arguments={},
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
Capabilities

  • Text prompt input
  • Duration control
  • Aspect ratio control

​
API Reference

​
Input Schema

​
prompt
string
Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both.
​
multi_prompt
list<KlingV3MultiPromptElement>
List of prompts for multi-shot video generation.
​
start_image_url
string
Image to use as the first frame of the video.
​
end_image_url
string
Image to use as the last frame of the video.
​
image_urls
list<string>
Reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 4 total (elements + reference images) when using video.
​
elements
list<KlingV3ComboElementInput>
Elements (characters/objects) to include. Reference in prompt as @Element1, @Element2.
​
generate_audio
boolean
default:"false"
Whether to generate native audio for the video.
​
duration
DurationEnum
default:"5"
Video duration in seconds (3-15s). Default value: "5"Possible values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
​
shot_type
string
default:"customize"
The type of multi-shot video generation. Default value: "customize"
​
aspect_ratio
AspectRatioEnum
default:"16:9"
The aspect ratio of the generated video frame. Default value: "16:9"Possible values: 16:9, 9:16, 1:1

​
Output Schema

​
video
File
required
The generated video.

​
Input Example

{
  "prompt": "@Element1 and @Element2 is having dinner at this table on @Image1",
  "multi_prompt": null,
  "start_image_url": "https://v3b.fal.media/files/b/0a8d1b63/EcYdmuNB1LTFjtn3Ryjrf_6ROoQV4u.png",
  "image_urls": [
    "https://v3b.fal.media/files/b/0a8d1b63/EcYdmuNB1LTFjtn3Ryjrf_6ROoQV4u.png"
  ],
  "elements": [
    {
      "frontal_image_url": "https://v3b.fal.media/files/b/0a8d1b64/-ddhNV-utVpHj_1uGfuY-_i6viYke3.png",
      "reference_image_urls": [
        "https://v3b.fal.media/files/b/0a8d1b5e/Gl1qUHJeTG63vAGtQmGM-_S3kPW32v.png"
      ]
    },
    {
      "frontal_image_url": "https://v3b.fal.media/files/b/0a8d1b66/cWe8LC84I_OF6ee9ZtnsO_nY9Hw5UB.png",
      "reference_image_urls": [
        "https://v3b.fal.media/files/b/0a8d1b60/Dt21s8LElZdSccIGDC7ec_Nuaraa9P.png"
      ]
    }
  ],
  "generate_audio": false,
  "duration": "8",
  "shot_type": "customize",
  "aspect_ratio": "16:9"
}

​
Output Example

{
  "video": {
    "content_type": "video/mp4",
    "file_name": "output.mp4",
    "file_size": 3192162,
    "url": "https://v3b.fal.media/files/b/0a8d200d/ejCxI5DalzOPlP4yf6uP3_output.mp4"
  }
}

​
Limitations

  • aspect_ratio restricted to: 16:9, 9:16, 1:1