FLUX 3

Video

Generate, animate, and continue video with FLUX 3, with synchronized audio in the same call.

Quickstart

FLUX 3 video is asynchronous: you submit a request, get back a polling_url, and poll it until the clip is Ready. For the full field list and response schema, see the API reference.

import os, time, requests

BFL_API_KEY = os.environ["BFL_API_KEY"]

# 1. Submit — returns an id and a polling_url
submit = requests.post(
    "https://api.bfl.ai/v1/flux-3-video",
    headers={"x-key": BFL_API_KEY, "Content-Type": "application/json"},
    json={
        "mode": "t2v",
        "prompt": "a fox running through dawn mist",
        "generate_audio": True,
    },
).json()

# 2. Poll the returned URL until the job is Ready
while True:
    time.sleep(2)
    result = requests.get(submit["polling_url"], headers={"x-key": BFL_API_KEY}).json()
    if result["status"] == "Ready":
        print(result["result"]["sample"])   # signed .mp4 URL
        break
    if result["status"] in ("Error", "Request Moderated", "Content Moderated"):
        raise RuntimeError(result["status"])

# 1. Submit — returns an id and a polling_url
curl -s -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "t2v",
    "prompt": "a fox running through dawn mist",
    "generate_audio": true
  }'

# 2. Poll the polling_url from the response until "status": "Ready"
curl -s "$POLLING_URL" -H "x-key: $BFL_API_KEY"

Modes

One mode per request; the rest of the request stays the same.

Text-to-Video (t2v) — prompt only.
Image-to-Video (i2v) — add keyframes: one image is the opening frame, [a, b] pins start and end, and up to ten frames pinned to timestamps become a storyboard.
Video Continuation (v2v) — add start_video; the clip continues from its final frames.

t2v · Generate a video with audio

i2v · Animate an image and use multiple keyframes

v2v · Extend your clip

Parameters

Full schema and per-field constraints live in the API reference.

Field	Required
`mode`	always	`t2v`, `i2v`, `v2v`, or `draft_enhance`.
`prompt`	always	What to generate.
`keyframes`	for `i2v`	One image starts the clip, two pin start and end, `[seconds, image]` pairs pin exact times. URL or base64.
`start_video`	for `v2v`	The clip to continue from, mp4 as URL or base64.
`draft_cache`	for `draft_enhance`	The bundle from a prior draft; reproduces that generation at full quality.
`resolution`		`hd` (default) or `fhd`.
`duration`		Whole seconds, 5 to 20, or `auto` (default).
`aspect_ratio`		`auto` (default), `21:9`, `2:1`, `16:9`, `4:3`, `1:1`, `3:4`, or `9:16`.
`generate_audio`		On by default. Set `false` for a silent clip.
`safety_tolerance`		0 (strictest) to 4, default 2.
`draft`		Set `true` for a fast hd preview; the result includes a `draft_cache` bundle.
`version`		`latest` (default) — always tracks the current release.

Use cases

Deeply customizable, and built for use cases, visual styles, and aspect ratios far beyond conventional cinematic output.

Text to video

Generate a clip from words alone — FLUX 3 handles everything from a single line to a densely directed brief, filling in framing, motion, and mood wherever you leave them open.

Example API call

cURL

curl -s -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "mode": "t2v",
    "prompt": "a fox running through dawn mist",
    "generate_audio": true
  }'

Image to video

Animate from images you pin. A single still becomes the exact opening frame, a start-and-end pair interpolates the motion between them, and several frames spread across the clip.

Example API call

cURL

curl -s -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "mode": "i2v",
    "prompt": "push forward through the trees",
    "keyframes": "https://example.com/still.jpg"
  }'

Multiple scenes

Block several shots and camera angles in one generation. Character, look, and continuity hold across hard cuts, with a single audio bed carrying through.

Example API call

cURL

curl -s -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "mode": "t2v",
    "prompt": "SHOT ONE: wide aerial of a desert highway at dawn. HARD CUT. SHOT TWO: interior close-up of the driver. HARD CUT. SHOT THREE: the car shrinks into the heat haze. One music bed across all shots.",
    "duration": 10
  }'

Multilingual dialogue

On-camera speech in many languages, with accurate accents and tight lipsync. Quote the line in your prompt and the character says it.

Example API call

cURL

curl -s -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "mode": "t2v",
    "prompt": "A presenter speaks to the lens: \"Storm season is here.\" Clean studio lighting.",
    "generate_audio": true
  }'

Broad range of styles

Photoreal cinematography, animation, motion design, and stylized looks — the same model spans styles far beyond conventional footage.

Example API call

cURL

curl -s -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "mode": "t2v",
    "prompt": "2D hand-drawn animation of a fox leaping through a paper-cut forest, bold flat colors",
    "aspect_ratio": "16:9"
  }'

Text and typography

Legible, well-placed text rendered as part of the scene — titles, signage, and lower-thirds that stay stable through motion.

Example API call

cURL

curl -s -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "mode": "t2v",
    "prompt": "Bold kinetic title card, the word \"FLUX\" assembling from light streaks on a dark stage",
    "aspect_ratio": "16:9"
  }'

Keyframes

Pin ordered keyframes and FLUX 3 interpolates one continuous shot through each — hit this pose, then this composition, then this — while the model handles the motion between them.

Example 1
Example 2
Example 3
Example 4

Start · 0:00

Key 2 · 0:03

Key 3 · 0:07

End · 0:10

Example API call

cURL

curl -s -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "mode": "i2v",
    "prompt": "a seed grows into a tree through the seasons",
    "duration": 10,
    "keyframes": [[0, "https://example.com/seed.png"], [4.5, "https://example.com/sapling.png"], [10, "https://example.com/tree.png"]]
  }'

Video continuation

Feed an existing clip and FLUX 3 picks up from its final frames, carrying momentum, framing, and scene logic forward without a cut.

Elephants
Penguin
Iguazú Falls
Giraffe
SUV drift

Example API call

cURL

curl -s -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "mode": "v2v",
    "prompt": "she takes his hand and pulls him laughing through the lantern-lit alley, the camera chasing them",
    "start_video": "https://example.com/clip.mp4",
    "duration": 10
  }'

Keep exploring

Prompting Guide

Prompt formats, the schema, camera language, and audio.

API reference

The full flux-3-video request contract: modes, fields, and constraints.

Playground

Try FLUX 3 in your browser — no setup required.

FLUX 3 overview

One request shape across image, video, and synchronized audio.

Get Started

Account Management

FLUX 3

FLUX.2

FLUX Tools

API Integration

Training

Legacy Models

Video

Video

Quickstart

Modes

Parameters

Use cases

Text to video

Image to video

Multiple scenes

Multilingual dialogue

Broad range of styles

Text and typography

Keyframes

Video continuation

Keep exploring

Prompting Guide

API reference

Playground

FLUX 3 overview

​Video

​Quickstart

​Modes

​Parameters

​Use cases

​Text to video

​Image to video

​Multiple scenes

​Multilingual dialogue

​Broad range of styles

​Text and typography

​Keyframes

​Video continuation

​Keep exploring

Prompting Guide

API reference

Playground

FLUX 3 overview

Video

Quickstart

Modes

Parameters

Use cases

Text to video

Image to video

Multiple scenes

Multilingual dialogue

Broad range of styles

Text and typography

Keyframes

Video continuation

Keep exploring