> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argil.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# FLUX 3 Max

> Generate a 5–20 s video with fal’s FLUX 3 Max from text, or from a start (and optional end) frame. 720p or 1080p, native audio.

Model id `flux-3-max` · Black Forest Labs · video · 2 modes: `text-to-video`, `image-to-video`.

> [!NOTE]
>
> This page reflects the current catalog. Inputs, allowed values, limits and prices can change as the model evolves; the field names and their meaning do not. For the exact schema at any time, your agent calls [`get_model`](https://docs.argil.ai/v2/mcp/tools) with the mode.

## Text To Video

Mode `text-to-video`. Text to video.

### Input

| Field | Type | Required | Allowed | Default | Description |
| - | - | - | - | - | - |
| `prompt` | string | Yes | up to 5,000 characters | | What the video should show: subject, action, camera and style. |
| `duration` | integer | | 5 to 20 | | Video duration in seconds. Integer 5–20; defaults to 5. |
| `aspect_ratio` | string | | `auto`, `21:9`, `2:1`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | | Aspect ratio. auto uses 16:9 for text and follows the start frame otherwise. |
| `resolution` | string | | `720p`, `1080p` | | 720p (default) or 1080p. |
| `generate_audio` | boolean | | | | Native audio with the video. Defaults to true. |
| `reasoning_level` | string | | `low`, `high` | | How much the prompt is expanded. high (default) is slower. |
| `seed` | integer | | | | Seed. Random when omitted. |

### Pricing

\~8.23 credits/s at 720p; 1080p is \$0.29/s.

Fixed price: charged as estimated.

For the exact price of a request, use [`estimate_generation`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "model": "flux-3-max",
  "mode": "text-to-video",
  "input": {
    "prompt": "A ginger cat walks into a sunlit kitchen, handheld camera",
    "duration": 5,
    "aspect_ratio": "21:9",
    "resolution": "720p"
  }
}
```

## Image To Video

Mode `image-to-video`. Animate a start frame, optionally to an end frame.

### Input

| Field | Type | Required | Allowed | Default | Description |
| - | - | - | - | - | - |
| `prompt` | string | Yes | up to 5,000 characters | | What the video should show: subject, action, camera and style. |
| `duration` | integer | | 5 to 20 | | Video duration in seconds. Integer 5–20; defaults to 5. |
| `aspect_ratio` | string | | `auto`, `21:9`, `2:1`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | | Aspect ratio. auto uses 16:9 for text and follows the start frame otherwise. |
| `resolution` | string | | `720p`, `1080p` | | 720p (default) or 1080p. |
| `generate_audio` | boolean | | | | Native audio with the video. Defaults to true. |
| `reasoning_level` | string | | `low`, `high` | | How much the prompt is expanded. high (default) is slower. |
| `seed` | integer | | | | Seed. Random when omitted. |
| `first_frame` | [File](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) | | | | The image to use as the first frame of the video. |
| `last_frame` | [File](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) | | | | Optional last frame: the video goes from the first to it. |

### Pricing

\~8.23 credits/s at 720p; 1080p is \$0.29/s.

Fixed price: charged as estimated.

For the exact price of a request, use [`estimate_generation`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "model": "flux-3-max",
  "mode": "image-to-video",
  "input": {
    "prompt": "A ginger cat walks into a sunlit kitchen, handheld camera",
    "duration": 5,
    "aspect_ratio": "21:9",
    "resolution": "720p"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.