> ## Documentation Index > Fetch the complete documentation index at: https://docs.bfl.ml/llms.txt > Use this file to discover all available pages before exploring further. # Video > Generate, animate, and continue video with FLUX 3. Edit existing footage with the separate FLUX Video Edit [fast] tool. export const CameraTermNav = ({sections, label} = {}) => { const SECTIONS = sections || [{ label: "Shot sizes", href: "#shot-sizes-and-framing" }, { label: "Angles", href: "#camera-angles" }, { label: "Composition", href: "#composition-techniques" }, { label: "Movements", href: "#camera-movements" }, { label: "Focus", href: "#focus-techniques" }, { label: "Lenses", href: "#lenses-and-optics" }, { label: "Shutter & time", href: "#shutter-and-time" }, { label: "Lighting", href: "#lighting-styles" }, { label: "Transitions", href: "#shot-transitions" }, { label: "POV", href: "#pov-and-specialty-rigs" }, { label: "Format", href: "#aspect-and-format" }, { label: "VFX", href: "#vfx-and-transformation" }, { label: "Art direction", href: "#art-direction" }, { label: "Animation", href: "#animation-and-media" }]; const OFFSET = 64; const [active, setActive] = useState(SECTIONS[0].href); const [pinned, setPinned] = useState(false); const [box, setBox] = useState({ left: 0, width: 0, height: 0 }); const [offset, setOffset] = useState(OFFSET); const wrapRef = useRef(null); const navRef = useRef(null); const listRef = useRef(null); const navbarRef = useRef(undefined); const navbarBottom = () => { if (typeof document === "undefined") return OFFSET; if (navbarRef.current === undefined) { const vw = document.documentElement.clientWidth; const found = Array.from(document.querySelectorAll("body div, header, nav")).find(el => { if (el.closest && el.closest(".camera-nav-wrap")) return false; const s = getComputedStyle(el); if (s.position !== "fixed" && s.position !== "sticky") return false; const r = el.getBoundingClientRect(); return r.top <= 0.5 && r.width > vw * 0.7 && r.height > 20 && r.height < 200; }); navbarRef.current = found || null; } const nb = navbarRef.current; if (!nb) return OFFSET; return Math.max(0, Math.round(nb.getBoundingClientRect().bottom)); }; const tickingRef = useRef(false); const scrollWiredRef = useRef(false); const measure = () => { const wrap = wrapRef.current; const nav = navRef.current; if (!wrap || !nav) return; const rect = wrap.getBoundingClientRect(); const off = navbarBottom(); setOffset(prev => prev === off ? prev : off); const shouldPin = rect.top <= off; setPinned(prev => prev === shouldPin ? prev : shouldPin); const left = Math.round(rect.left); const width = Math.round(rect.width); const height = nav.offsetHeight; setBox(prev => prev.left === left && prev.width === width && prev.height === height ? prev : { left, width, height }); const vw = document.documentElement.clientWidth; const GUTTER = 40; const bleed = Math.max(0, Math.round(vw - rect.right - GUTTER)); document.documentElement.style.setProperty("--camera-bleed", `${bleed}px`); updateActive(off + height + 24); }; const onScroll = () => { if (tickingRef.current) return; tickingRef.current = true; requestAnimationFrame(() => { tickingRef.current = false; measure(); }); }; const attachWrap = el => { wrapRef.current = el; if (!el || scrollWiredRef.current || typeof window === "undefined") return; scrollWiredRef.current = true; window.addEventListener("scroll", onScroll, true); window.addEventListener("resize", onScroll); if (typeof requestAnimationFrame !== "undefined") { requestAnimationFrame(measure); } else { measure(); } }; const centerPill = href => { const root = navRef.current; if (!root) return; const el = root.querySelector(`[data-href="${href}"]`); if (el && el.scrollIntoView) { el.scrollIntoView({ block: "nearest", inline: "center", behavior: "smooth" }); } }; const activeRef = useRef(SECTIONS[0].href); const updateActive = line => { if (typeof document === "undefined") return; let best = SECTIONS[0].href; let bestTop = -Infinity; SECTIONS.forEach(s => { [s, ...s.children || []].forEach(item => { const node = document.getElementById(item.href.slice(1)); if (!node) return; const top = node.getBoundingClientRect().top; if (top <= line && top > bestTop) { bestTop = top; best = item.href; } }); }); const doc = document.documentElement; if (window.innerHeight + window.scrollY >= doc.scrollHeight - 2) { const last = SECTIONS[SECTIONS.length - 1]; const kids = last.children || []; const href = kids.length ? kids[kids.length - 1].href : last.href; const node = document.getElementById(href.slice(1)); if (node && node.getBoundingClientRect().top < window.innerHeight) best = href; } if (best === activeRef.current) return; activeRef.current = best; setActive(best); centerPill(best); }; const attachNav = el => { navRef.current = el; }; const navStyle = pinned ? { position: "fixed", top: `${offset}px`, left: `${box.left}px`, width: `${box.width}px` } : undefined; const activeParent = SECTIONS.find(s => s.href === active || (s.children || []).some(c => c.href === active)) || SECTIONS[0]; const subItems = activeParent.children || []; const isParentActive = s => s.href === active || (s.children || []).some(c => c.href === active); return
; }; export const VideoExtension = ({src, poster, originalDuration = 5, aspectRatio = "16 / 9", accent = "#3ecf8e", alt = ""}) => { const videoRef = useRef(null); const [playing, setPlaying] = useState(true); const [muted, setMuted] = useState(true); const [dur, setDur] = useState(0); const [t, setT] = useState(0); const orig = dur ? Math.min(originalDuration, dur) : originalDuration; const split = dur ? Math.min(Math.max(orig / dur, 0.06), 0.94) : 0.5; const progress = dur ? Math.min(t / dur, 1) : 0; const inExt = dur > 0 && t >= orig - 0.05; const fmt = s => { s = Math.max(0, Math.round(s || 0)); const m = Math.floor(s / 60); return `${m}:${String(s % 60).padStart(2, "0")}`; }; const onMeta = e => setDur(e.currentTarget.duration || 0); const onTime = e => setT(e.currentTarget.currentTime || 0); const onPlay = () => setPlaying(true); const onPause = () => setPlaying(false); const togglePlay = () => { const v = videoRef.current; if (!v) return; if (v.paused) { const p = v.play?.(); if (p && typeof p.catch === "function") p.catch(() => {}); } else { v.pause(); } }; const toggleMute = () => { const v = videoRef.current; const next = !muted; setMuted(next); if (v) v.muted = next; }; const seek = e => { const v = videoRef.current; if (!v || !dur) return; const r = e.currentTarget.getBoundingClientRect(); const x = (e.clientX - r.left) / r.width; v.currentTime = Math.min(Math.max(x, 0), 1) * dur; setT(v.currentTime); }; const neutral = a => `color-mix(in srgb, currentColor ${a}%, transparent)`; const iconBtn = { position: "absolute", top: "0.9rem", right: "0.9rem", zIndex: 4, display: "inline-flex", alignItems: "center", justifyContent: "center", width: "2.4rem", height: "2.4rem", padding: 0, borderRadius: "999px", border: "none", background: "rgba(12, 14, 18, 0.62)", backdropFilter: "blur(6px)", color: "#fff", cursor: "pointer", transition: "background 160ms ease" }; return
{}
{}
{}
{}
{}
{}
{}
{}
{}
Original {fmt(orig)} {fmt(t)} / {fmt(dur)} FLUX 3 continuation +{fmt(Math.max(dur - orig, 0))}
; }; export const AnimateSlider = ({items = []}) => { const [inView, setInView] = useState(0); const [edges, setEdges] = useState({ left: false, right: items.length > 1 }); const [muted, setMuted] = useState(true); const trackRef = useRef(null); const cardRefs = useRef([]); const slideRefs = useRef([]); const measuredRef = useRef(false); const mutedRef = useRef(true); const setSlideRef = (idx, key) => el => { if (!slideRefs.current[idx]) slideRefs.current[idx] = {}; slideRefs.current[idx][key] = el; }; const showStill = (idx, show) => { const s = slideRefs.current[idx]; if (!s) return; if (s.still) s.still.style.opacity = show ? "1" : "0"; if (s.pill) s.pill.style.opacity = show ? "1" : "0"; }; const stop = idx => { const s = slideRefs.current[idx]; if (!s || !s.video) return; s.video.pause?.(); try { s.video.currentTime = 0; } catch (e) {} showStill(idx, true); }; const toggle = idx => { const s = slideRefs.current[idx]; if (!s || !s.video) return; if (s.video.paused) { s.video.muted = mutedRef.current; showStill(idx, false); const p = s.video.play?.(); if (p && typeof p.catch === "function") p.catch(() => {}); } else { stop(idx); } }; const observerRef = useRef(null); const getObserver = () => { if (observerRef.current) return observerRef.current; if (typeof IntersectionObserver === "undefined") return null; observerRef.current = new IntersectionObserver(entries => { entries.forEach(entry => { if (!entry.isIntersecting) { const idx = Number(entry.target.getAttribute("data-idx")); if (!Number.isNaN(idx)) stop(idx); } }); }, { threshold: 0.25 }); return observerRef.current; }; const attachMedia = idx => el => { setSlideRef(idx, "media")(el); if (!el) return; const io = getObserver(); if (io) io.observe(el); }; const toggleMute = e => { e.stopPropagation(); const next = !muted; setMuted(next); mutedRef.current = next; slideRefs.current.forEach(s => { if (s && s.video) s.video.muted = next; }); }; const updateEdges = el => { if (!el) return; const max = el.scrollWidth - el.clientWidth; const next = { left: el.scrollLeft > 4, right: el.scrollLeft < max - 4 }; setEdges(prev => prev.left === next.left && prev.right === next.right ? prev : next); const cards = cardRefs.current.filter(Boolean); if (cards.length) { let best = 0; let bestDist = Infinity; cards.forEach((card, i) => { const dist = Math.abs(card.offsetLeft - el.scrollLeft - 4); if (dist < bestDist) { bestDist = dist; best = i; } }); setInView(prev => prev === best ? prev : best); } }; const attachTrack = el => { trackRef.current = el; if (!el || measuredRef.current) return; measuredRef.current = true; if (typeof requestAnimationFrame !== "undefined") { requestAnimationFrame(() => updateEdges(el)); } else { updateEdges(el); } }; const scrollByCard = dir => { const el = trackRef.current; if (!el) return; const first = cardRefs.current.find(Boolean); const cardW = first ? first.offsetWidth + 20 : el.clientWidth * 0.8; el.scrollBy({ left: dir * cardW, behavior: "smooth" }); }; const scrollToCard = idx => { const el = trackRef.current; const card = cardRefs.current[idx]; if (!el || !card) return; el.scrollTo({ left: card.offsetLeft - 4, behavior: "smooth" }); }; const muteBtnStyle = { position: "absolute", top: "0.6rem", right: "0.6rem", zIndex: 4, width: "2rem", height: "2rem", borderRadius: "999px", border: "none", background: "rgba(8, 18, 13, 0.5)", color: "#fff", display: "inline-flex", alignItems: "center", justifyContent: "center", cursor: "pointer", backdropFilter: "blur(4px)", WebkitBackdropFilter: "blur(4px)" }; return
updateEdges(e.currentTarget)}> {items.map((item, idx) =>
{ cardRefs.current[idx] = el; }}> {item.title &&

{item.title}

}
toggle(idx)} onKeyDown={e => { if (e.key === "Enter" || e.key === " ") { e.preventDefault(); toggle(idx); } }} style={{ cursor: "pointer", userSelect: "none", WebkitTapHighlightColor: "transparent" }}>
{item.prompt && 
{item.prompt}
}
)}
{items.length > 1 &&
{items.map((item, idx) =>
}
; }; export const ClipSlider = ({items = []}) => { const [copied, setCopied] = useState(-1); const [inView, setInView] = useState(0); const [edges, setEdges] = useState({ left: false, right: items.length > 1 }); const [muted, setMuted] = useState(true); const [viewer, setViewer] = useState(null); const [split, setSplit] = useState({}); const splitAt = idx => split[idx] === undefined ? items[idx] && items[idx].split !== undefined ? items[idx].split : 50 : split[idx]; const moveSplit = (idx, e) => { const r = e.currentTarget.getBoundingClientRect(); const pct = Math.max(0, Math.min(100, (e.clientX - r.left) / r.width * 100)); setSplit(s => ({ ...s, [idx]: pct })); }; const BOX_COLORS = ["#e8b04a", "#6fb3d9", "#e0708a", "#8fcf7a", "#b99af0", "#f08b5b", "#5fd0c0", "#d9d36f", "#9fb0c8", "#f2a3c7", "#7aa0f0", "#c7e07a"]; const fitBox = ([y0, x0, y1, x1], w, h) => { const frame = 16 / 9, ar = w / h; const sx = ar > frame ? 1 : ar / frame, sy = ar > frame ? frame / ar : 1; const ox = (1 - sx) / 2, oy = (1 - sy) / 2; return { top: (oy + y0 / 1000 * sy) * 100 + "%", left: (ox + x0 / 1000 * sx) * 100 + "%", height: (y1 - y0) / 1000 * sy * 100 + "%", width: (x1 - x0) / 1000 * sx * 100 + "%" }; }; const [actualSize, setActualSize] = useState(false); const trackRef = useRef(null); const cardRefs = useRef([]); const measuredRef = useRef(false); const mutedRef = useRef(true); const videosRef = useRef([]); const observerRef = useRef(null); const getObserver = () => { if (observerRef.current) return observerRef.current; if (typeof IntersectionObserver === "undefined") return null; observerRef.current = new IntersectionObserver(entries => { entries.forEach(entry => { const v = entry.target; if (entry.isIntersecting) { v.muted = mutedRef.current; const p = v.play?.(); if (p && typeof p.catch === "function") p.catch(() => {}); } else { v.pause?.(); } }); }, { threshold: 0.4 }); return observerRef.current; }; const attachVideo = el => { if (!el) return; if (!videosRef.current.includes(el)) videosRef.current.push(el); const io = getObserver(); if (io) io.observe(el); }; const toggleMute = () => { const next = !muted; setMuted(next); mutedRef.current = next; videosRef.current.forEach(v => { if (v) v.muted = next; }); }; const updateEdges = el => { if (!el) return; const max = el.scrollWidth - el.clientWidth; const next = { left: el.scrollLeft > 4, right: el.scrollLeft < max - 4 }; setEdges(prev => prev.left === next.left && prev.right === next.right ? prev : next); const cards = cardRefs.current.filter(Boolean); if (cards.length) { let best = 0; let bestDist = Infinity; cards.forEach((card, i) => { const dist = Math.abs(card.offsetLeft - el.scrollLeft - 4); if (dist < bestDist) { bestDist = dist; best = i; } }); setInView(prev => prev === best ? prev : best); } }; const attachTrack = el => { trackRef.current = el; if (!el || measuredRef.current) return; measuredRef.current = true; if (typeof requestAnimationFrame !== "undefined") { requestAnimationFrame(() => updateEdges(el)); } else { updateEdges(el); } }; const scrollByCard = dir => { const el = trackRef.current; if (!el) return; const first = cardRefs.current.find(Boolean); const cardW = first ? first.offsetWidth + 20 : el.clientWidth * 0.8; el.scrollBy({ left: dir * cardW, behavior: "smooth" }); }; const scrollToCard = idx => { const el = trackRef.current; const card = cardRefs.current[idx]; if (!el || !card) return; el.scrollTo({ left: card.offsetLeft - 4, behavior: "smooth" }); }; const startVideo = event => { const video = event.currentTarget; video.muted = mutedRef.current; const p = video.play?.(); if (p && typeof p.catch === "function") p.catch(() => {}); }; const copy = (text, idx) => { try { navigator.clipboard.writeText(text); setCopied(idx); setTimeout(() => setCopied(c => c === idx ? -1 : c), 2000); } catch (e) {} }; return
updateEdges(e.currentTarget)}> {items.map((item, idx) =>
{ cardRefs.current[idx] = el; }}> {item.title &&

{item.title}

}
{item.before ?
{ e.currentTarget.setPointerCapture?.(e.pointerId); moveSplit(idx, e); }} onPointerMove={e => { if (e.buttons) moveSplit(idx, e); }} onKeyDown={e => { if (e.key === "ArrowLeft" || e.key === "ArrowRight") { e.preventDefault(); setSplit(s => ({ ...s, [idx]: Math.max(0, Math.min(100, splitAt(idx) + (e.key === "ArrowLeft" ? -5 : 5))) })); } }}> {item.alt
{item.alt
: item.image ? : <>
{item.prompt && 
{item.prompt}
}
)}
{items.length > 1 &&
{items.map((item, idx) =>
} {viewer !== null && items[viewer] ? { if (node && !node.open) node.showModal(); }} onClose={() => setViewer(null)} onClick={() => setViewer(null)}> {items[viewer].alt { event.stopPropagation(); setActualSize(!actualSize); }} />
event.stopPropagation()}>
: null}
; }; export const MutedVideo = ({src, poster, alt = "", aspectRatio = "16 / 9", borderRadius = "0.75rem"}) => { const videoRef = useRef(null); const [muted, setMuted] = useState(true); const start = event => { const v = event.currentTarget; v.muted = muted; const p = v.play?.(); if (p && typeof p.catch === "function") p.catch(() => {}); }; const toggleMute = () => { const v = videoRef.current; const next = !muted; setMuted(next); if (v) v.muted = next; }; const iconBtn = { position: "absolute", top: "0.9rem", right: "0.9rem", zIndex: 3, display: "inline-flex", alignItems: "center", justifyContent: "center", width: "2.4rem", height: "2.4rem", padding: 0, borderRadius: "999px", border: "none", background: "rgba(12, 14, 18, 0.62)", backdropFilter: "blur(6px)", color: "#fff", cursor: "pointer", transition: "background 160ms ease" }; return
; }; export const VideoComparisonSlider = ({beforeVideo, afterVideo, beforeLabel = "Before", afterLabel = "After", height = "500px", objectFit = "cover", poster}) => { const makeLogic = () => { const STEP = 2; const PAGE_STEP = 10; const clampPercent = value => Number.isFinite(value) ? Math.max(0, Math.min(100, value)) : 0; const percentFromX = (clientX, rect) => { if (!rect || !rect.width || !Number.isFinite(clientX)) return 0; return clampPercent((clientX - rect.left) / rect.width * 100); }; const keyPosition = (key, current) => { const at = clampPercent(current); if (key === "ArrowLeft" || key === "ArrowDown") return clampPercent(at - STEP); if (key === "ArrowRight" || key === "ArrowUp") return clampPercent(at + STEP); if (key === "PageDown") return clampPercent(at - PAGE_STEP); if (key === "PageUp") return clampPercent(at + PAGE_STEP); if (key === "Home") return 0; if (key === "End") return 100; return null; }; const valueText = (position, before, after) => { const left = Math.round(clampPercent(position)); return `${left}% ${before}, ${100 - left}% ${after}`; }; return { clampPercent, percentFromX, keyPosition, valueText }; }; const L = makeLogic(); const [position, setPosition] = useState(50); const [playing, setPlaying] = useState(true); const beforeRef = useRef(null); const afterRef = useRef(null); const userPausedRef = useRef(false); const lastAutoResumeRef = useRef(0); const DRIFT_S = 0.04; const SEEK_S = 0.5; const readPosition = (e, container) => { const rect = container.getBoundingClientRect(); const clientX = e.touches ? e.touches[0].clientX : e.clientX; return L.percentFromX(clientX, rect); }; const onPointerDown = e => { e.preventDefault(); e.stopPropagation(); const container = e.currentTarget; if (typeof container.focus === "function") container.focus(); setPosition(readPosition(e, container)); const onMove = ev => { ev.preventDefault(); setPosition(readPosition(ev, container)); }; const onUp = () => { window.removeEventListener("mousemove", onMove); window.removeEventListener("mouseup", onUp); window.removeEventListener("touchmove", onMove); window.removeEventListener("touchend", onUp); }; window.addEventListener("mousemove", onMove); window.addEventListener("mouseup", onUp); window.addEventListener("touchmove", onMove, { passive: false }); window.addEventListener("touchend", onUp); }; const onKeyDown = e => { const next = L.keyPosition(e.key, position); if (next === null) return; e.preventDefault(); e.stopPropagation(); setPosition(next); }; const loopPoint = () => { const a = beforeRef.current; const b = afterRef.current; if (!a || !b) return 0; const da = Number.isFinite(a.duration) ? a.duration : 0; const db = Number.isFinite(b.duration) ? b.duration : 0; if (!da || !db) return da || db; return Math.min(da, db); }; const resync = force => { const a = beforeRef.current; const b = afterRef.current; if (!a || !b) return; if (b.readyState < 1) return; const delta = b.currentTime - a.currentTime; if (force || Math.abs(delta) > SEEK_S) { try { b.currentTime = a.currentTime; } catch (e) {} b.playbackRate = 1; } else if (Math.abs(delta) > DRIFT_S) { const rate = 1 - Math.max(-0.08, Math.min(0.08, delta * 0.5)); b.playbackRate = rate; } else { b.playbackRate = 1; } if (a.paused && !b.paused) b.pause(); if (!a.paused && b.paused) { const p = b.play?.(); if (p && typeof p.catch === "function") p.catch(() => {}); } }; const restart = () => { if (userPausedRef.current) return; const a = beforeRef.current; const b = afterRef.current; if (!a) return; try { a.currentTime = 0; } catch (e) {} if (b) { try { b.currentTime = 0; } catch (e) {} } const p = a.play?.(); if (p && typeof p.catch === "function") p.catch(() => {}); if (b) { const q = b.play?.(); if (q && typeof q.catch === "function") q.catch(() => {}); } }; const setBeforeRef = el => { beforeRef.current = el; if (!el || el.dataset.vcsWired === "1") return; el.dataset.vcsWired = "1"; el.addEventListener("timeupdate", () => { const end = loopPoint(); if (end && el.currentTime >= end - 0.12) { restart(); return; } resync(false); }); el.addEventListener("ended", restart); el.addEventListener("seeked", () => resync(true)); el.addEventListener("play", () => { if (userPausedRef.current) { el.pause(); return; } setPlaying(true); resync(true); }); el.addEventListener("pause", () => { const rect = el.getBoundingClientRect(); const inView = rect.bottom > 0 && rect.top < window.innerHeight && rect.right > 0 && rect.left < window.innerWidth; const now = Date.now(); if (!userPausedRef.current && !el.ended && !document.hidden && inView && now - lastAutoResumeRef.current > 250) { lastAutoResumeRef.current = now; const p = el.play?.(); if (p && typeof p.catch === "function") { p.catch(() => { setPlaying(false); resync(true); }); } return; } setPlaying(false); resync(true); }); el.addEventListener("loadeddata", () => resync(true)); }; const setAfterRef = el => { afterRef.current = el; if (!el || el.dataset.vcsWired === "1") return; el.dataset.vcsWired = "1"; el.addEventListener("play", () => { if (userPausedRef.current) el.pause(); }); el.addEventListener("loadeddata", () => resync(true)); }; const togglePlay = e => { e.preventDefault(); e.stopPropagation(); const a = beforeRef.current; if (!a) return; if (!playing) { userPausedRef.current = false; const p = a.play?.(); if (p && typeof p.catch === "function") p.catch(() => {}); } else { userPausedRef.current = true; setPlaying(false); a.pause(); } resync(true); }; const videoStyle = { position: "absolute", top: 0, left: 0, width: "100%", height: "100%", objectFit, pointerEvents: "none" }; const labelStyle = { position: "absolute", top: "12px", padding: "4px 10px", borderRadius: "6px", background: "rgba(0,0,0,0.55)", backdropFilter: "blur(4px)", color: "#fff", fontSize: "0.75rem", fontWeight: 600, letterSpacing: "0.02em", pointerEvents: "none", zIndex: 4 }; return
{ e.preventDefault(); e.stopPropagation(); }} style={{ position: "relative", width: "100%", height, overflow: "hidden", cursor: "ew-resize", userSelect: "none", WebkitUserSelect: "none", background: "#000", outlineOffset: "-3px" }}> {}
; }; export const PromptDisplay = ({prompt}) => { const [copied, setCopied] = useState(false); const copy = () => { navigator.clipboard.writeText(prompt); setCopied(true); setTimeout(() => setCopied(false), 2000); }; return

{prompt}

; };
FLUX 3 Motion from a single line artwork

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](/api-reference/utility/generate-a-video-with-flux-3). ```python Python theme={null} 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"]) ``` ```bash cURL theme={null} # 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 Each `/v1/flux-3-video` request names a `mode`. Media fields and accepted parameter values depend on that mode; check the API reference before reusing a request across modes. * **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. For editing, use the separate FLUX Video Edit \[fast] tool at `/v1/flux-tools/video-edit-v1`, documented on its [own page](/flux_tools/flux_video_edit). Send `video` and `prompt`, not a `mode`.

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](/api-reference/utility/generate-a-video-with-flux-3). | 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), `fhd`, `qhd`, or `uhd`. See [Resolution](#resolution). | | `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`, `9:16`, or `9:21`. | | `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. | ### Resolution `hd` is delivered straight off the generation. `fhd`, `qhd`, and `uhd` run the same generation and finish it with the video upsampler on a larger canvas, so the shot is identical across all four and only the delivered size differs. | Aspect ratio | `hd` | `fhd` | `qhd` | `uhd` | | - | - | - | - | - | | 21:9 | 1440 × 608 | 2176 × 928 | 2912 × 1248 | 4352 × 1856 | | 2:1 | 1344 × 672 | 2016 × 1024 | 2720 × 1376 | 4032 × 2048 | | 16:9 | 1280 × 704 | 1920 × 1088 | 2560 × 1440 | 3840 × 2176 | | 4:3 | 1088 × 800 | 1632 × 1216 | 2176 × 1632 | 3264 × 2432 | | 1:1 | 960 × 960 | 1440 × 1440 | 1920 × 1920 | 2880 × 2880 | | 3:4 | 800 × 1088 | 1216 × 1632 | 1632 × 2176 | 2432 × 3264 | | 9:16 | 704 × 1280 | 1088 × 1920 | 1440 × 2560 | 2176 × 3840 | | 9:21 | 608 × 1440 | 928 × 2176 | 1248 × 2912 | 1856 × 4352 | Dimensions are multiples of 32, so a class does not always land on the round number its name suggests: `uhd` at 16:9 delivers 3840 × 2176 rather than 3840 × 2160, the same way `fhd` delivers 1920 × 1088. Crop the delivered frame if you need an exact standard size. Drafts always render at `hd`: sending `draft: true` with any other resolution is rejected. `draft_enhance` accepts all four classes and defaults to `fhd`, so the delivery size is chosen when you commit a draft, not when you preview it. ## 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.
```bash cURL theme={null} 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.
```bash cURL theme={null} 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.
```bash cURL theme={null} 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.
```bash cURL theme={null} 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 Specify the visual style in the prompt: live action, animation, or motion graphics.
```bash cURL theme={null} 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 Describe the words and their placement to generate titles, signs, or lower-thirds within the video.
```bash cURL theme={null} 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 Provide ordered keyframes to guide a continuous shot through specific poses and compositions. FLUX 3 generates the motion between them.
Keyframe: Start (0:00)

Start (0:00)

Keyframe: Key 2 (0:03)

Key 2 (0:03)

Keyframe: Key 3 (0:07)

Key 3 (0:07)

Keyframe: End (0:10)

End (0:10)
Keyframe: Start

Start

Keyframe: Key 2

Key 2

Keyframe: Key 3

Key 3

Keyframe: End

End
Keyframe: Start (0:00)

Start (0:00)

Keyframe: Key 2 (0:03)

Key 2 (0:03)

Keyframe: Key 3 (0:07)

Key 3 (0:07)

Keyframe: End (0:10)

End (0:10)
Keyframe: Start (0:00)

Start (0:00)

Keyframe: Key 2 (0:03)

Key 2 (0:03)

Keyframe: Key 3 (0:07)

Key 3 (0:07)

Keyframe: End (0:10)

End (0:10)

 ```bash cURL theme={null} 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. ```bash cURL theme={null} 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 }' ``` ### Video editing The example below requests two changes to an existing clip: remove the pedestrians and add pigeons around the fountain. FLUX Video Edit \[fast] takes the source clip as `video` and the edit instruction as `prompt` at `POST /v1/flux-tools/video-edit-v1`. Poll the returned `polling_url` until `Ready` and download `result.sample`. Twelve edits on one clip, the request fields, limits and pricing are on the [FLUX Video Edit page](/flux_tools/flux_video_edit). ## Keep exploring Prompt formats, the schema, camera language, and audio. The full flux-3-video request contract: modes, fields, and constraints. Try FLUX 3 in your browser: no setup required. One request shape across image, video, and synchronized audio.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.