Sign in

v1

latestOpenAPI 3.0.42026-07-174610.3 KB

post/fal-ai/kling-video/v3/standard/image-to-video

Request body

promptstring

Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both.

aspect_ratio'16:9' | '9:16' | '1:1'

The aspect ratio of the generated video frame

duration'3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15'

The duration of the generated video in seconds

generate_audioboolean

Whether to generate native audio for the video. Supports Chinese and English voice output. Other languages are automatically translated to English. For English speech, use lowercase letters; for acronyms or proper nouns, use uppercase.

voice_idsstring[]

Optional Voice IDs for video generation. Reference voices in your prompt with <<<voice_1>>> and <<<voice_2>>> (maximum 2 voices per task). Get voice IDs from the kling video create-voice endpoint: https://fal.ai/models/fal-ai/kling-video/create-voice

start_image_urlstring required

URL of the image to be used for the video

shot_type'customize'

The type of multi-shot video generation. Required when multi_prompt is provided.

end_image_urlstring

URL of the image to be used for the end of the video

negative_promptstring
cfg_scalenumber
        The CFG (Classifier Free Guidance) scale is a measure of how close you want
        the model to stick to your prompt.

Response

The request status.

status'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED' required
request_idstring required

The request id.

response_urlstring

The response url.

status_urlstring

The status url.

cancel_urlstring

The cancel url.

logsobject

The logs.

metricsobject

The metrics.

queue_positioninteger

The queue position.