# FLUX 3 Max Text 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/text-to-video`
- **Model ID**: `blackforestlabs/flux-3-max/text-to-video`
- **Category**: text-to-video
- **Kind**: inference
**Description**: FLUX 3 Max text to video from Black Forest Labs. Input: prompt. 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**: text-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 the video you want to generate.
  - Examples: "A red panda walks along a mossy log in a sunlit forest, pausing to sniff the air before climbing over a fallen branch. Soft morning light filters through the canopy. Ambient birdsong and rustling leaves."

- **`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": "A red panda walks along a mossy log in a sunlit forest, pausing to sniff the air before climbing over a fallen branch. Soft morning light filters through the canopy. Ambient birdsong and rustling leaves."
}
```

**Full Example**:

```json
{
  "prompt": "A red panda walks along a mossy log in a sunlit forest, pausing to sniff the air before climbing over a fallen branch. Soft morning light filters through the canopy. Ambient birdsong and rustling leaves.",
  "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/0aad95e5/Yk8T8_MXiLBhuphmPfeqR_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/0aad95e5/Yk8T8_MXiLBhuphmPfeqR_alligator.mp4",
    "num_frames": 121,
    "fps": 24
  }
}
```


## Usage Examples

### cURL

```bash
curl --request POST \
  --url https://fal.run/blackforestlabs/flux-3-max/text-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
     "prompt": "A red panda walks along a mossy log in a sunlit forest, pausing to sniff the air before climbing over a fallen branch. Soft morning light filters through the canopy. Ambient birdsong and rustling leaves."
   }'
```

### 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/text-to-video",
    arguments={
        "prompt": "A red panda walks along a mossy log in a sunlit forest, pausing to sniff the air before climbing over a fallen branch. Soft morning light filters through the canopy. Ambient birdsong and rustling leaves."
    },
    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/text-to-video", {
  input: {
    prompt: "A red panda walks along a mossy log in a sunlit forest, pausing to sniff the air before climbing over a fallen branch. Soft morning light filters through the canopy. Ambient birdsong and rustling leaves."
  },
  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/text-to-video)
- [API Documentation](https://fal.ai/models/blackforestlabs/flux-3-max/text-to-video/api)
- [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=blackforestlabs/flux-3-max/text-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/<endpoint-id>/llms.txt`