# FLUX 3 Max Image to Video > fal’s FLUX 3 Max is a post-trained variant of FLUX 3 Video, tuned for stronger prompt adherence and better visual quality while optimized for lower latency. ## Overview - **Endpoint**: `https://fal.run/blackforestlabs/flux-3-max/image-to-video` - **Model ID**: `blackforestlabs/flux-3-max/image-to-video` - **Category**: image-to-video - **Kind**: inference **Description**: FLUX 3 Max image to video from Black Forest Labs. Input: image_url (PNG, JPEG or WebP, the first frame), optional end_image_url (the last frame) and a prompt describing how the video unfolds. Options: duration 5-20 seconds (default 5), aspect_ratio (auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16; default auto), generate_audio (default true), reasoning_level low or high (default high, the model expands your prompt), seed. Output: 720p video with native audio. Billed per second of generated video. **Tags**: image-to-video, fast, audio ## Pricing Video costs **$0.0425** per second at **720p** and **$0.0725** per second at **1080p**. Note: these are promotional rates, **75%** off for a limited time. The discount runs from **October 15** to **November 7**, after which **720p** is **$0.17**/second and **1080p** is **$0.29**/second. For more details, see [fal.ai pricing](https://fal.ai/pricing). ## API Information This model can be used via our HTTP API or more conveniently via our client libraries. See the input and output schema below, as well as the usage examples. ### Input Schema The API accepts the following input parameters: - **`prompt`** (`string`, _required_): The text prompt describing how the video unfolds from the image. - Examples: "The monkey leans into his microphone and says, \"Welcome back to the show!\" The polar bear laughs and nods along, tapping the desk. Jungle birdsong on the left, a cold wind on the right." - **`image_url`** (`string`, _required_): URL of the image the video starts from (PNG, JPEG, or WebP). - Examples: "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg" - **`end_image_url`** (`string`, _optional_): Optional URL of the image used as the last frame of the video (PNG, JPEG, or WebP). - **`duration`** (`DurationEnum`, _optional_): Duration of the generated video in seconds. Default value: `"5"` - Default: `5` - Options: `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20` - **`resolution`** (`ResolutionEnum`, _optional_): Resolution of the generated video. Default value: `"720p"` - Default: `"720p"` - Options: `"720p"`, `"1080p"` - **`reasoning_level`** (`ReasoningLevelEnum`, _optional_): How much effort the harness spends reasoning about the given prompt. Higher reasoning effort means slower generation time. Default value: `"high"` - Default: `"high"` - Options: `"low"`, `"high"` - **`aspect_ratio`** (`AspectRatioEnum`, _optional_): Aspect ratio of the generated video. `auto` uses 16:9 for text prompts and follows the first image otherwise. Default value: `"auto"` - Default: `"auto"` - Options: `"auto"`, `"21:9"`, `"2:1"`, `"16:9"`, `"4:3"`, `"1:1"`, `"3:4"`, `"9:16"` - **`generate_audio`** (`boolean`, _optional_): Whether to generate audio for the video. Default value: `true` - Default: `true` - **`seed`** (`integer`, _optional_): The seed to use for the generation. Random when not provided. **Required Parameters Example**: ```json { "prompt": "The monkey leans into his microphone and says, \"Welcome back to the show!\" The polar bear laughs and nods along, tapping the desk. Jungle birdsong on the left, a cold wind on the right.", "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg" } ``` **Full Example**: ```json { "prompt": "The monkey leans into his microphone and says, \"Welcome back to the show!\" The polar bear laughs and nods along, tapping the desk. Jungle birdsong on the left, a cold wind on the right.", "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg", "duration": 5, "resolution": "720p", "reasoning_level": "high", "aspect_ratio": "auto", "generate_audio": true } ``` ### Output Schema The API returns the following output format: - **`video`** (`VideoFile`, _required_): The generated video. - Examples: {"height":704,"content_type":"video/mp4","width":1280,"duration":5.041666666666667,"url":"https://v3b.fal.media/files/b/0aad95e6/ESYZjWfb88A3PeyaAqCbD_alligator.mp4","num_frames":121,"fps":24} - **`seed`** (`integer`, _required_): The seed used for the generation. - **`timings`** (`Timings`, _optional_): `inference`: seconds the model spent denoising the video. Excludes prompt expansion, decoding and upload. **Example Response**: ```json { "video": { "height": 704, "content_type": "video/mp4", "width": 1280, "duration": 5.041666666666667, "url": "https://v3b.fal.media/files/b/0aad95e6/ESYZjWfb88A3PeyaAqCbD_alligator.mp4", "num_frames": 121, "fps": 24 } } ``` ## Usage Examples ### cURL ```bash curl --request POST \ --url https://fal.run/blackforestlabs/flux-3-max/image-to-video \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "prompt": "The monkey leans into his microphone and says, \"Welcome back to the show!\" The polar bear laughs and nods along, tapping the desk. Jungle birdsong on the left, a cold wind on the right.", "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg" }' ``` ### Python Ensure you have the Python client installed: ```bash pip install fal-client ``` Then use the API client to make requests: ```python 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( "blackforestlabs/flux-3-max/image-to-video", arguments={ "prompt": "The monkey leans into his microphone and says, \"Welcome back to the show!\" The polar bear laughs and nods along, tapping the desk. Jungle birdsong on the left, a cold wind on the right.", "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg" }, with_logs=True, on_queue_update=on_queue_update, ) print(result) ``` ### JavaScript Ensure you have the JavaScript client installed: ```bash npm install --save @fal-ai/client ``` Then use the API client to make requests: ```javascript import { fal } from "@fal-ai/client"; const result = await fal.subscribe("blackforestlabs/flux-3-max/image-to-video", { input: { prompt: "The monkey leans into his microphone and says, \"Welcome back to the show!\" The polar bear laughs and nods along, tapping the desk. Jungle birdsong on the left, a cold wind on the right.", image_url: "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg" }, 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); ``` ## Additional Resources ### Documentation - [Model Playground](https://fal.ai/models/blackforestlabs/flux-3-max/image-to-video) - [API Documentation](https://fal.ai/models/blackforestlabs/flux-3-max/image-to-video/api) - [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=blackforestlabs/flux-3-max/image-to-video) ### fal.ai Platform - [Platform Documentation](https://fal.ai/docs/documentation) - [Python Client](https://fal.ai/docs/api-reference/client-libraries/python) - [JavaScript Client](https://fal.ai/docs/api-reference/client-libraries/javascript) ### Other agent-readable surfaces This file covers one model. To find anything else: - [Platform overview](https://fal.ai/llms.txt): Entry points and representative endpoint IDs - [Documentation index](https://fal.ai/docs/llms.txt): Every documentation page - [Full documentation text](https://fal.ai/docs/llms-full.txt): The whole documentation inlined - Any other model: `https://fal.ai/models//llms.txt`