Generate a video with FLUX 3 Max

curl --request POST \
  --url https://queue.fal.run/blackforestlabs/flux-3-max/text-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "A continuous helmet-mounted POV tails a woman on a dirt bike racing across rolling desert dunes, her tracks the only marks on the wind-sculpted sand. The view dips and jolts over each crest as she kicks up golden arcs into the low, raking sun. The engine snarls and roars, the only sound in the sunlit void.",
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}'

curl --request POST \
  --url https://queue.fal.run/blackforestlabs/flux-3-max/image-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "Dashcam view of a moose crossing a snowy highway at dusk, wipers sweeping, brake lights reflecting on ice.",
  "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/d0cadba3ca86e84c1e6d86de87555a20f522f62c-1280x704.jpg",
  "duration": 10
}'

curl --request POST \
  --url https://queue.fal.run/blackforestlabs/flux-3-max/keyframes-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "One continuous shot following a cave diver through a dark underwater cavern: her torch beam sweeps the rock, she glides past a wall of glowing blue coral, swims through a swirling cloud of bioluminescent plankton, and rises toward shafts of sunlight at the cave mouth.",
  "keyframes": [
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/809c8dc93242314493c4ae613e9ebfba26b7b14f-2752x1536.jpg", "frame_index": 0 },
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/716f9cad904a337d7d54cbe3fa69d8cc8fb6fde5-2752x1536.jpg", "frame_index": 72 },
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/b4855f2bcf674551255248f4f30a2f213ed34e68-2752x1536.jpg", "frame_index": 168 },
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/b591a58d3a4a94472dbb7e69f3f40859cc6d3731-2752x1536.jpg", "frame_index": 240 }
  ],
  "duration": 10
}'

{
  "status": "IN_QUEUE",
  "request_id": "<string>",
  "response_url": "<string>",
  "status_url": "<string>",
  "cancel_url": "<string>",
  "logs": {},
  "metrics": {},
  "queue_position": 123
}

POST

blackforestlabs

flux-3-max

text-to-video

curl --request POST \
  --url https://queue.fal.run/blackforestlabs/flux-3-max/text-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "A continuous helmet-mounted POV tails a woman on a dirt bike racing across rolling desert dunes, her tracks the only marks on the wind-sculpted sand. The view dips and jolts over each crest as she kicks up golden arcs into the low, raking sun. The engine snarls and roars, the only sound in the sunlit void.",
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}'

curl --request POST \
  --url https://queue.fal.run/blackforestlabs/flux-3-max/image-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "Dashcam view of a moose crossing a snowy highway at dusk, wipers sweeping, brake lights reflecting on ice.",
  "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/d0cadba3ca86e84c1e6d86de87555a20f522f62c-1280x704.jpg",
  "duration": 10
}'

curl --request POST \
  --url https://queue.fal.run/blackforestlabs/flux-3-max/keyframes-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "One continuous shot following a cave diver through a dark underwater cavern: her torch beam sweeps the rock, she glides past a wall of glowing blue coral, swims through a swirling cloud of bioluminescent plankton, and rises toward shafts of sunlight at the cave mouth.",
  "keyframes": [
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/809c8dc93242314493c4ae613e9ebfba26b7b14f-2752x1536.jpg", "frame_index": 0 },
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/716f9cad904a337d7d54cbe3fa69d8cc8fb6fde5-2752x1536.jpg", "frame_index": 72 },
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/b4855f2bcf674551255248f4f30a2f213ed34e68-2752x1536.jpg", "frame_index": 168 },
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/b591a58d3a4a94472dbb7e69f3f40859cc6d3731-2752x1536.jpg", "frame_index": 240 }
  ],
  "duration": 10
}'

{
  "status": "IN_QUEUE",
  "request_id": "<string>",
  "response_url": "<string>",
  "status_url": "<string>",
  "cancel_url": "<string>",
  "logs": {},
  "metrics": {},
  "queue_position": 123
}

Set a fal API key as the FAL_KEY environment variable. Requests and billing go through your fal account.

Text to video
Image to video
Keyframes to video

Describe your video in prompt and send the request to https://queue.fal.run/blackforestlabs/flux-3-max/text-to-video.

Send your prompt and an image URL as image_url to https://queue.fal.run/blackforestlabs/flux-3-max/image-to-video. Your video starts from that image. Optionally, add end_image_url to choose the last frame.Every other field in the Body section below works the same way. The playground sends text-to-video requests; for the image-to-video schema, see fal’s reference.

Send your prompt and up to 10 keyframes to https://queue.fal.run/blackforestlabs/flux-3-max/keyframes-to-video. Each keyframe is an image_url pinned to a frame_index in the 24 fps output, so second 3 is frame 72. Indices must be unique and at most duration × 24. Use prompt to describe the motion between keyframes.Every other field in the Body section below works the same way. For the keyframes-to-video schema, see fal’s reference.

See FLUX 3 Max for samples.

Retrieve your video

The response includes a status_url and a response_url. Poll the first until status is COMPLETED, then fetch the second. The video is at video.url.

# 1. Poll until "status": "COMPLETED"
curl --header "Authorization: Key $FAL_KEY" "$STATUS_URL"

# 2. Fetch the result
curl --header "Authorization: Key $FAL_KEY" "$RESPONSE_URL"

curl --request POST \
  --url https://queue.fal.run/blackforestlabs/flux-3-max/text-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "A continuous helmet-mounted POV tails a woman on a dirt bike racing across rolling desert dunes, her tracks the only marks on the wind-sculpted sand. The view dips and jolts over each crest as she kicks up golden arcs into the low, raking sun. The engine snarls and roars, the only sound in the sunlit void.",
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}'

curl --request POST \
  --url https://queue.fal.run/blackforestlabs/flux-3-max/image-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "Dashcam view of a moose crossing a snowy highway at dusk, wipers sweeping, brake lights reflecting on ice.",
  "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/d0cadba3ca86e84c1e6d86de87555a20f522f62c-1280x704.jpg",
  "duration": 10
}'

curl --request POST \
  --url https://queue.fal.run/blackforestlabs/flux-3-max/keyframes-to-video \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "One continuous shot following a cave diver through a dark underwater cavern: her torch beam sweeps the rock, she glides past a wall of glowing blue coral, swims through a swirling cloud of bioluminescent plankton, and rises toward shafts of sunlight at the cave mouth.",
  "keyframes": [
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/809c8dc93242314493c4ae613e9ebfba26b7b14f-2752x1536.jpg", "frame_index": 0 },
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/716f9cad904a337d7d54cbe3fa69d8cc8fb6fde5-2752x1536.jpg", "frame_index": 72 },
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/b4855f2bcf674551255248f4f30a2f213ed34e68-2752x1536.jpg", "frame_index": 168 },
    { "image_url": "https://cdn.sanity.io/images/2gpum2i6/production/b591a58d3a4a94472dbb7e69f3f40859cc6d3731-2752x1536.jpg", "frame_index": 240 }
  ],
  "duration": 10
}'

Authorizations

Authorization

string

header

required

Fal Key

Body

application/json

prompt

string

required

The text prompt describing the video you want to generate.

Minimum string length: 1

Example:

"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

enum<integer>

default:5

Duration of the generated video in seconds.

Available options:

5,

6,

7,

8,

9,

10,

11,

12,

13,

14,

15,

16,

17,

18,

19,

20

reasoning_level

enum<string>

default:high

How much effort the harness spends reasoning about the given prompt. Higher reasoning effort means slower generation time.

Available options:

low,

high

resolution

enum<string>

default:720p

Resolution of the generated video. 1080p, 2K (1440p) and 4K (2160p) are upscaled from the 720p generation; exact dimensions depend on the aspect ratio.

Available options:

720p,

1080p,

2K,

4K

generate_audio

boolean

default:true

Whether to generate audio for the video.

aspect_ratio

enum<string>

default:auto

Aspect ratio of the generated video. auto uses 16:9 for text prompts and follows the first image otherwise.

Available options:

auto,

21:9,

2:1,

16:9,

4:3,

1:1,

3:4,

9:16

seed

integer | null

The seed to use for the generation. Random when not provided.

Response

200 - application/json

The request status.

status

enum<string>

required

Available options:

IN_QUEUE,

IN_PROGRESS,

COMPLETED

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.

General

FLUX 3 Models

FLUX.2 Models

FLUX.2 Klein Models

FLUX Tools

Legacy Models

Fine-tuning

Licensing

Generate a video with FLUX 3 Max

Authorizations

Body

Response