FLUX 3 Max

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

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 with the mode.

Text To Video

Mode text-to-video. Text to video.

Input

Field	Type	Required	Allowed	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.

Example

The arguments of generate_media:

{
  "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	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			The image to use as the first frame of the video.
`last_frame`	File			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.

Example

The arguments of generate_media:

{
  "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"
  }
}

Models

Video

Image

Audio

Text To Video

Input

Pricing

Example

Image To Video

Input

Pricing

Example

​Text To Video

​Input

​Pricing

​Example

​Image To Video

​Input

​Pricing

​Example

Text To Video

Input

Pricing

Example

Image To Video

Input

Pricing

Example