---
title: "POST /fal-ai/kling-video/v3/standard/image-to-video"
method: POST
path: "/fal-ai/kling-video/v3/standard/image-to-video"
---

# POST /fal-ai/kling-video/v3/standard/image-to-video

`POST /fal-ai/kling-video/v3/standard/image-to-video`

## Request body

- KlingVideoV3StandardImageToVideoInput — V3 standard image-to-video request model.
  - `prompt` string — 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_audio` boolean — 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.
  - `multi_prompt` KlingV3MultiPromptElement[] — List of prompts for multi-shot video generation. If provided, divides the video into multiple shots.
    - `prompt` string, required — The prompt for this shot.
    - `duration` '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' — The duration of this shot in seconds
  - `voice_ids` string[] — 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_url` string, 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.
  - `elements` KlingV3ComboElementInput[] — Elements (characters/objects) to include in the video. Each example can either be an image set (frontal + reference images) or a video. Reference in prompt as @Element1, @Element2, etc.
    - `video_url` string — The video URL of the element. A request can only have one element with a video. Max file size: 200.0MB, Min width: 720px, Min height: 720px, Max width: 2160px, Max height: 2160px, Min duration: 3.0s, Max duration: 10.05s, Min FPS: 24.0, Max FPS: 60.0, Timeout: 30.0s
    - `reference_image_urls` string[] — Additional reference images from different angles. 1-3 images supported. At least one image is required.
    - `frontal_image_url` string — The frontal image of the element (main view). Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s
  - `end_image_url` string — URL of the image to be used for the end of the video
  - `negative_prompt` string
  - `cfg_scale` number — The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt.

## Response `200`

The request status.

- QueueStatus
  - `status` 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED', required
  - `request_id` string, required — The request id.
  - `response_url` string — The response url.
  - `status_url` string — The status url.
  - `cancel_url` string — The cancel url.
  - `logs` object — The logs.
  - `metrics` object — The metrics.
  - `queue_position` integer — The queue position.

---

[API](https://skmtc.net/edenartlab/apis/queue-openapi-for-fal-ai-kling-video-v3-standard-image-to-vi.md) · [All operations](https://skmtc.net/edenartlab/apis/queue-openapi-for-fal-ai-kling-video-v3-standard-image-to-vi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/edenartlab/queue-openapi-for-fal-ai-kling-video-v3-standard-image-to-vi/revisions/9cb02417d96c/schema)