> ## 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. # FLUX 3 Image Editing > Edit an image with a written instruction, combine up to ten references, and use bounding boxes to place elements or target an edit with FLUX 3 Image. export const FLUX3_EDITING_BBOX_EXAMPLES = [{ "key": "editing-moth", "title": "Leopard-print moth", "op": "pattern", "instruction": "Change the solid black moth to a leopard print pattern.", "before": "https://cdn.sanity.io/images/2gpum2i6/production/5c92570a2416c438d6d4de79527c1f63119a500f-1800x1192.webp", "after": "https://cdn.sanity.io/images/2gpum2i6/production/3a7ea6a52fc19507ed2f9d17a5dc26f98a6e38f5-1800x1192.webp", "width": 1800, "height": 1192, "record": "Modify the sharply focused moth on the left side of the glowing light fixture in . Replace it with a new moth that features a distinct leopard print pattern on its wings, while maintaining the original flat triangular shape against the white background. Keep all other elements exactly unchanged, including the two sharp moths and on the upper right, the blurred flying moths and , and the scattered tiny insects and shadows .", "rows": [{ "id": "light_fixture_1", "from": "ref_image_0", "src_bbox": [0, 0, 850, 1000], "tgt_bbox": [0, 0, 850, 1000], "desc": "A large, glowing spherical light fixture filling the upper and central frame. Its surface is a textured, matte white with subtle imperfections and a faint horizontal seam running across the middle. It emits a diffuse, brilliant internal light, leaving the bottom area of the frame in deep black shadow.", "kind": "anchor" }, { "id": "moth_1", "from": null, "src_bbox": null, "tgt_bbox": [350, 150, 480, 300], "desc": "A sharply focused silhouetted moth with a distinct leopard print pattern on its wings, maintaining its flat triangular shape against the white background.", "kind": "new" }, { "id": "moth_2", "from": "ref_image_0", "src_bbox": [120, 750, 220, 880], "tgt_bbox": [120, 750, 220, 880], "desc": "A distinct, black silhouette of a moth with spread wings, resting near the top right edge of the light fixture.", "kind": "anchor" }, { "id": "moth_3", "from": "ref_image_0", "src_bbox": [150, 850, 260, 960], "tgt_bbox": [150, 850, 260, 960], "desc": "A sharp moth silhouette clustered near another moth, angled slightly downward, presenting a crisp, dark outline.", "kind": "anchor" }, { "id": "moth_4", "from": "ref_image_0", "src_bbox": [450, 800, 600, 950], "tgt_bbox": [450, 800, 600, 950], "desc": "A dark, blurred streak representing a moth in motion, leaving a soft, out-of-focus shadow trail across the white surface.", "kind": "anchor" }, { "id": "moth_5", "from": "ref_image_0", "src_bbox": [650, 200, 800, 350], "tgt_bbox": [650, 200, 800, 350], "desc": "An out-of-focus, dark shape of a moth caught in mid-flight, its wings blurring into a soft, grainy smudge.", "kind": "anchor" }, { "id": "insect_swarm_1", "from": "ref_image_0", "src_bbox": [50, 50, 820, 950], "tgt_bbox": [50, 50, 820, 950], "desc": "Dozens of tiny black dots, small gnats, and soft out-of-focus shadows scattered randomly across the white surface of the light fixture.", "kind": "anchor" }] }, { "key": "editing-waterfall", "title": "Golden waterfall", "op": "recolour", "instruction": "Change the white waterfall to a golden-yellow hue.", "before": "https://cdn.sanity.io/images/2gpum2i6/production/a49c048fa5f9d5fccc31afbe8e08983213e2d31c-1192x1800.webp", "after": "https://cdn.sanity.io/images/2gpum2i6/production/e34420bc057863f90411c420f8478dc049ac0994-1192x1800.webp", "width": 1192, "height": 1800, "record": "Modify by changing the central cascading water into a long exposure silky golden-yellow waterfall . Keep the rest of the image exactly unchanged, including the textured dark rock face behind the falls, the evergreen trees at the top of the cliff, the misty white water at the base, and the dark wet rocks in the bottom foreground.", "rows": [{ "id": "waterfall", "from": null, "src_bbox": null, "tgt_bbox": [57, 349, 837, 784], "desc": "long exposure silky golden-yellow waterfall", "kind": "new" }, { "id": "rock_wall", "from": "ref_image_0", "src_bbox": [102, 0, 600, 1000], "tgt_bbox": [102, 0, 600, 1000], "desc": "textured dark rock face behind the waterfall", "kind": "anchor" }, { "id": "trees", "from": "ref_image_0", "src_bbox": [0, 132, 156, 762], "tgt_bbox": [0, 132, 156, 762], "desc": "evergreen trees at the top of the cliff", "kind": "anchor" }, { "id": "mist_pool", "from": "ref_image_0", "src_bbox": [765, 42, 912, 943], "tgt_bbox": [765, 42, 912, 943], "desc": "misty white water at the base of the falls", "kind": "anchor" }, { "id": "foreground_rocks", "from": "ref_image_0", "src_bbox": [901, 570, 985, 744], "tgt_bbox": [901, 570, 985, 744], "desc": "dark wet rocks in the bottom foreground", "kind": "anchor" }] }, { "key": "editing-silk", "title": "Metallic silk", "op": "material", "instruction": "Change the purple fabric to metallic silk.", "before": "https://cdn.sanity.io/images/2gpum2i6/production/7b386fdaa3dab06baf4e1c9ed44f872442b82937-1800x1350.webp", "after": "https://cdn.sanity.io/images/2gpum2i6/production/beeec7b5f21a8ad135d9937a97b09f55b48c3c0e-1800x1350.webp", "width": 1800, "height": 1350, "record": "In , change the long, flowing purple semi-transparent fabric in the middle to a long, flowing purple metallic silk fabric . Keep the pink fabric , orange fabric , green fabric , blue fabric , the ocean waves , and the sandy beach exactly unchanged.", "rows": [{ "id": "pink_fabric", "from": "ref_image_0", "src_bbox": [379, 53, 722, 350], "tgt_bbox": [379, 53, 722, 350], "desc": "long, flowing pink semi-transparent fabric", "kind": "anchor" }, { "id": "orange_fabric", "from": "ref_image_0", "src_bbox": [394, 144, 740, 563], "tgt_bbox": [394, 144, 740, 563], "desc": "long, flowing orange semi-transparent fabric", "kind": "anchor" }, { "id": "purple_fabric", "from": null, "src_bbox": null, "tgt_bbox": [468, 252, 663, 705], "desc": "long, flowing purple metallic silk fabric", "kind": "new" }, { "id": "green_fabric", "from": "ref_image_0", "src_bbox": [530, 493, 737, 807], "tgt_bbox": [530, 493, 737, 807], "desc": "long, flowing green semi-transparent fabric", "kind": "anchor" }, { "id": "blue_fabric", "from": "ref_image_0", "src_bbox": [536, 627, 742, 936], "tgt_bbox": [536, 627, 742, 936], "desc": "long, flowing blue semi-transparent fabric", "kind": "anchor" }, { "id": "ocean_waves", "from": "ref_image_0", "src_bbox": [492, 0, 778, 1000], "tgt_bbox": [492, 0, 778, 1000], "desc": "ocean waves crashing onto the shore", "kind": "anchor" }, { "id": "sandy_beach", "from": "ref_image_0", "src_bbox": [662, 0, 1000, 1000], "tgt_bbox": [662, 0, 1000, 1000], "desc": "sandy beach with small pebbles", "kind": "anchor" }] }, { "key": "editing-mesa", "title": "Obsidian mesa", "op": "material", "instruction": "Change the central mesa to polished black obsidian.", "before": "https://cdn.sanity.io/images/2gpum2i6/production/a1145500294444d48fe99ab5689594450b466e2e-1800x895.webp", "after": "https://cdn.sanity.io/images/2gpum2i6/production/da5417274d17263801f247c02f62a971bc570945-1800x895.webp", "width": 1800, "height": 895, "record": "In , change the flat-topped rocky mesa in the middle distance to a flat-topped mesa made of polished black obsidian with a reflective surface. Ensure the glossy black material catches the ambient light and reflects the starry sky above. Keep the arching Milky Way , the eroded clay ridges in the foreground, and the distant horizon completely untouched.", "rows": [{ "id": "milky_way", "from": "ref_image_0", "src_bbox": [70, 119, 655, 917], "tgt_bbox": [70, 119, 655, 917], "desc": "the milky way galaxy arching across the night sky", "kind": "anchor" }, { "id": "central_mesa", "from": null, "src_bbox": null, "tgt_bbox": [657, 322, 746, 547], "desc": "a flat-topped mesa made of polished black obsidian with a reflective surface", "kind": "new" }, { "id": "foreground_ridges", "from": "ref_image_0", "src_bbox": [707, 3, 995, 996], "tgt_bbox": [707, 3, 995, 996], "desc": "eroded clay ridges and badlands in the foreground", "kind": "anchor" }, { "id": "distant_horizon", "from": "ref_image_0", "src_bbox": [652, 0, 724, 323], "tgt_bbox": [652, 0, 724, 323], "desc": "the far horizon line under the twilight glow", "kind": "anchor" }] }]; export const FLUX3_PIXEL_EXAMPLES = [{ "key": "cats", "title": "Remove a cat", "op": "Remove", "change": "Orange cat removed", "input": "https://cdn.sanity.io/images/2gpum2i6/production/8fc2d013a3912a101e10aa116841adae9b930f74-1600x898.webp", "edited": "https://cdn.sanity.io/images/2gpum2i6/production/cfd2c6cf8f18a212d053b5efe0e18ea7eb1e3c5b-1600x898.webp", "mask": "https://cdn.sanity.io/images/2gpum2i6/production/8b251636c81303d1217c97308b4e676b3c4692ce-1600x898.png", "width": 1600, "height": 898, "identical": "80.7%", "pixels": 3491600, "full_res": [2494, 1400] }, { "key": "bird", "title": "Add a bird", "op": "Add", "change": "Small bird added on the currants", "input": "https://cdn.sanity.io/images/2gpum2i6/production/c5ebc86b4050a2844ccd12ef0ec6e6f1eb168790-1600x1206.webp", "edited": "https://cdn.sanity.io/images/2gpum2i6/production/3ecf4e4ead6470ffd183833f5cee24dce231c70a-1600x1206.webp", "mask": "https://cdn.sanity.io/images/2gpum2i6/production/7a95f780e59c40614ecc7765d04582ee9e837c5f-1600x1206.png", "width": 1600, "height": 1206, "identical": "86.4%", "pixels": 2601200, "full_res": [1858, 1400] }, { "key": "burger", "title": "Swap the plate", "op": "Replace", "change": "Plate swapped for a burger", "input": "https://cdn.sanity.io/images/2gpum2i6/production/e80c3c8f6d928356f5f4479644cdce033193a827-1191x1400.webp", "edited": "https://cdn.sanity.io/images/2gpum2i6/production/6290ac98c2b96eaead51063171e6d2b6dcf29bdc-1191x1400.webp", "mask": "https://cdn.sanity.io/images/2gpum2i6/production/a5fc3618762649a4cef0a78bd86c25ec6b188894-1191x1400.png", "width": 1191, "height": 1400, "identical": "88.4%", "pixels": 1667400, "full_res": [1191, 1400] }, { "key": "shirt", "title": "Print on a shirt", "op": "Add", "change": "Cat print added to the T-shirt", "input": "https://cdn.sanity.io/images/2gpum2i6/production/0558a5d7996849b1fbda6aa00572d9f3d14ba809-1400x1400.webp", "edited": "https://cdn.sanity.io/images/2gpum2i6/production/6eb5c77713772f7c46abea03f6a3be6dda2ba53f-1400x1400.webp", "mask": "https://cdn.sanity.io/images/2gpum2i6/production/0898adeaf7ccae59dbb4d3e44093b0d4ece67ac5-1400x1400.png", "width": 1400, "height": 1400, "identical": "89.7%", "pixels": 1960000, "full_res": [1400, 1400] }, { "key": "duck", "title": "Replace the duck", "op": "Replace", "change": "Rubber duck replaced", "input": "https://cdn.sanity.io/images/2gpum2i6/production/1fc2e839e624487f872609395cf0a67dc303b0b5-1600x1189.webp", "edited": "https://cdn.sanity.io/images/2gpum2i6/production/3d12f59a624a022ac12554242aa404be64db5b9d-1600x1189.webp", "mask": "https://cdn.sanity.io/images/2gpum2i6/production/1d01fcec8d4273fe6bc998242a4950ac798b8543-1600x1189.png", "width": 1600, "height": 1189, "identical": "85.5%", "pixels": 2637600, "full_res": [1884, 1400] }, { "key": "hair", "title": "Recolor hair", "op": "Recolour", "change": "Hair recolored blue", "input": "https://cdn.sanity.io/images/2gpum2i6/production/6c2f4e7142e08a45343f735da9c6979ac78fd528-1046x1400.webp", "edited": "https://cdn.sanity.io/images/2gpum2i6/production/381358b6b1fcda8eaba213bc70d27f7a754f2fb6-1046x1400.webp", "mask": "https://cdn.sanity.io/images/2gpum2i6/production/e65e9abb341ceaebf84893240d3f6428a49bb86b-1046x1400.png", "width": 1046, "height": 1400, "identical": "67.8%", "pixels": 1464400, "full_res": [1046, 1400] }, { "key": "moto", "title": "Add a rider", "op": "Add", "change": "Motorcyclist added in the bend", "input": "https://cdn.sanity.io/images/2gpum2i6/production/942f0e77c30e850c4114f7adc0e45869a591edd2-1600x663.webp", "edited": "https://cdn.sanity.io/images/2gpum2i6/production/69ef6ce42514482eed365cc8c57b974e3947a27b-1600x663.webp", "mask": "https://cdn.sanity.io/images/2gpum2i6/production/c133740c9eb19b1b59f2a1da18822d84ce83c175-1600x663.png", "width": 1600, "height": 663, "identical": "89.2%", "pixels": 4732000, "full_res": [3380, 1400] }, { "key": "sofa", "title": "New sofa", "op": "Replace", "change": "Armchairs replaced with a sofa", "input": "https://cdn.sanity.io/images/2gpum2i6/production/8a3546c271532f377c5707d5edc52265028b569d-1600x1067.webp", "edited": "https://cdn.sanity.io/images/2gpum2i6/production/5125bc353896ff5de2dd73d84cc7838e9ea8670a-1600x1067.webp", "mask": "https://cdn.sanity.io/images/2gpum2i6/production/ba22eacfac502719104a658652f2262e2280616a-1600x1067.png", "width": 1600, "height": 1067, "identical": "76.5%", "pixels": 2940000, "full_res": [2100, 1400] }, { "key": "divers", "title": "Two tiny divers", "op": "Add", "change": "Two divers added", "input": "https://cdn.sanity.io/images/2gpum2i6/production/a48094ab64a9008f77088440bd8f2919aca25e8c-1600x1060.webp", "edited": "https://cdn.sanity.io/images/2gpum2i6/production/662d38c3e6d14780f62b0db45ae19333420d416f-1600x1060.webp", "mask": "https://cdn.sanity.io/images/2gpum2i6/production/2d37fae000aa2287e0b3cc39ffb5f61117739df5-1600x1060.png", "width": 1600, "height": 1060, "identical": "94.1%", "pixels": 2958200, "full_res": [2113, 1400] }]; export const EditExplorer = ({examples = [], mediaBase = ""}) => { const KIND = { new: { label: "New", color: "#e0708a", note: "Generate at tgt_bbox" }, move: { label: "Move", color: "#6fb3d9", note: "Move from src_bbox to tgt_bbox" }, anchor: { label: "Anchor", color: "#9fb0c8", note: "Keep at the same position" } }; const [index, setIndex] = useState(0); const [view, setView] = useState("after"); const [anchors, setAnchors] = useState(false); const [active, setActive] = useState(null); const [copied, setCopied] = useState(false); const [loaded, setLoaded] = useState({}); const [failed, setFailed] = useState({}); const ex = examples[index]; if (!ex) return null; const before = mediaBase + ex.before, after = mediaBase + ex.after; const ready = loaded[before] && loaded[after]; const reveal = async (image, key) => { try { await image.decode(); setLoaded(current => ({ ...current, [key]: true })); } catch { setFailed(current => ({ ...current, [key]: true })); } }; const pct = ([y0, x0, y1, x1]) => ({ top: y0 / 10 + "%", left: x0 / 10 + "%", height: (y1 - y0) / 10 + "%", width: (x1 - x0) / 10 + "%" }); const wire = ex.rows.map(({id, from, src_bbox, tgt_bbox, desc}) => ({ id, from, src_bbox, tgt_bbox, desc })); const body = { prompt: ex.record + " " + JSON.stringify(wire), images: [typeof window === "undefined" ? mediaBase + ex.before : new URL(mediaBase + ex.before, window.location.href).href] }; const changed = ex.rows.filter(r => r.kind !== "anchor"); const shown = anchors ? ex.rows : changed; const parts = ex.record.split(/(<[A-Za-z0-9_]+>)/g).filter(Boolean); const kindOf = id => (ex.rows.find(r => r.id === id) || ({})).kind; const pick = i => { setCopied(false); setIndex(i); setView("after"); setActive(null); }; const copy = async () => { try { await navigator.clipboard.writeText(JSON.stringify(body, null, 2)); setCopied(true); setTimeout(() => setCopied(false), 1800); } catch (e) { setCopied(false); } }; const hot = id => ({ onMouseEnter: () => setActive(id), onMouseLeave: () => setActive(null), onFocus: () => setActive(id), onBlur: () => setActive(null) }); return
{examples.length > 1 ?
{examples.map((example, i) => )}
: null}
{!ready &&
{failed[before] || failed[after] ? "Image unavailable. Choose another example or reload to retry." : "Loading example…"}
}
reveal(event.currentTarget, before)} onError={() => setFailed(current => ({ ...current, [before]: true }))} alt={ex.title + ": the image before the edit"} width={ex.width} height={ex.height} /> reveal(event.currentTarget, after)} onError={() => setFailed(current => ({ ...current, [after]: true }))} alt={ex.title + ": the image after the edit"} style={{ opacity: view === "after" ? 1 : 0 }} /> {shown.map(r => { const c = KIND[r.kind].color; const cls = (...extra) => { const list = ["ex-box", ...extra]; if (active && active !== r.id) list.push("is-dim"); if (active === r.id) list.push("is-hot"); return list.join(" "); }; const boxes = []; if (r.kind === "move" && view === "before") boxes.push(
{r.id} · src_bbox
); if (r.tgt_bbox && !(r.kind === "move" && view === "before")) boxes.push(
{r.kind === "move" ? r.id + " · tgt_bbox" : r.id}
); return boxes; })}

The change

{ex.instruction}

Full prompt

{parts.map((part, i) => { const m = part.match(/^<([A-Za-z0-9_]+)>$/); if (!m) return {part}; const kind = kindOf(m[1]); if (!kind) return {part}; return {part}; })}

Elements

    {shown.map(r =>
  • {r.id} {KIND[r.kind].label}
    from: {JSON.stringify(r.from)} · src: {JSON.stringify(r.src_bbox)} · tgt: {JSON.stringify(r.tgt_bbox)}
    {r.desc}
    • )}
; }; 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 PixelDiff = ({examples = [], mediaBase = ""}) => { const [index, setIndex] = useState(0); const [view, setView] = useState("edited"); const ex = examples[index]; if (!ex) return null; const pick = i => { setIndex(i); setView("edited"); }; return
{examples.map((e, i) => )}

Input

{ex.title

{view === "mask" ? "Changed pixels" : "Edited"}

{ex.title {ex.title

{ex.change}. In Changed pixels, bright areas changed and black areas match the input.

; }; export const BboxExplorer = () => { const ROOT = "/images/flux3/bbox/"; const SPOTS = [{ id: "fire", box: [520, 340, 820, 640], items: ["campfire", "tent", "boulder"] }, { id: "meadow", box: [440, 650, 720, 920], items: ["fox", "fawn", "hedgehog", "badger"] }, { id: "roots", box: [380, 50, 660, 330], items: ["burrow", "toadstool", "rabbits"] }, { id: "canopy", box: [40, 280, 300, 660], items: ["swing", "birds", "treehouse"] }]; const pct = ([y0, x0, y1, x1]) => ({ top: y0 / 10 + "%", left: x0 / 10 + "%", height: (y1 - y0) / 10 + "%", width: (x1 - x0) / 10 + "%" }); const stage = useRef(null); const [placed, setPlaced] = useState({}); const [drag, setDrag] = useState(null); const [menu, setMenu] = useState(null); const [typing, setTyping] = useState(null); const [miss, setMiss] = useState(false); const [from, setFrom] = useState(null); useEffect(() => { if (!from) return; const r = requestAnimationFrame(() => requestAnimationFrame(() => setFrom(null))); return () => cancelAnimationFrame(r); }, [from]); useEffect(() => { SPOTS.forEach(s => s.items.forEach(i => { new Image().src = `${ROOT}${s.id}-${i}.webp`; })); }, []); useEffect(() => { if (!typing) return; const label = typing.item + "_1"; if (typing.n >= label.length) { const t = setTimeout(() => { setPlaced(p => ({ ...p, [typing.spot]: typing.item })); setTyping(null); }, 350); return () => clearTimeout(t); } const t = setTimeout(() => setTyping({ ...typing, n: typing.n + 1 }), 55); return () => clearTimeout(t); }, [typing]); const point = e => { const r = stage.current.getBoundingClientRect(); const k = v => Math.max(0, Math.min(1000, Math.round(v * 1000))); return [k((e.clientY - r.top) / r.height), k((e.clientX - r.left) / r.width)]; }; const down = e => { if (typing || e.button > 0) return; const [y, x] = point(e); e.currentTarget.setPointerCapture(e.pointerId); setMenu(null); setMiss(false); setDrag({ start: [y, x], box: [y, x, y, x] }); }; const move = e => { if (!drag) return; const [y, x] = point(e), [sy, sx] = drag.start; setDrag({ ...drag, box: [Math.min(sy, y), Math.min(sx, x), Math.max(sy, y), Math.max(sx, x)] }); }; const up = () => { if (!drag) return; const [y0, x0, y1, x1] = drag.box; const overlap = s => Math.max(0, Math.min(y1, s.box[2]) - Math.max(y0, s.box[0])) * Math.max(0, Math.min(x1, s.box[3]) - Math.max(x0, s.box[1])); const hit = SPOTS.map(s => [s, overlap(s) || (y0 >= s.box[0] && y0 <= s.box[2] && x0 >= s.box[1] && x0 <= s.box[3] ? 1 : 0)]).sort((a, b) => b[1] - a[1])[0]; setDrag(null); if (hit[1] > 0) { setFrom(drag.box); setMenu(hit[0].id); } else setMiss(true); }; const choose = (spot, item) => { setMenu(null); setTyping({ spot, item, n: 0 }); }; const spot = id => SPOTS.find(s => s.id === id); const active = typing ? typing.spot : menu; const last = typing || Object.keys(placed).length ? typing || ({ spot: Object.keys(placed).slice(-1)[0], item: Object.values(placed).slice(-1)[0] }) : null; const entity = last && JSON.stringify([{ id: last.item + "_1", from: null, src_bbox: null, tgt_bbox: spot(last.spot).box, desc: last.item }]); const n = Object.keys(placed).length; const caption = typing ? ["Placing " + typing.item, "Writing <" + typing.item + "_1> into the box"] : menu ? ["Choose what goes here", "Pick one of the saved edits for this box"] : miss ? ["Nothing there yet", "Try a marked region"] : n ? [n + " of " + SPOTS.length + " spots filled", "Draw a box over another marked region"] : ["Choose a region", "Draw a box over a marked region"]; return
Place an object

Draw over a marked region and choose an object to see a saved edit in that region.

Pre-generated edits
setDrag(null)}> A storybook forest clearing {Object.entries(placed).map(([id, item]) => {`${item})} {!drag && SPOTS.filter(s => !placed[s.id] && s.id !== active).map(s =>
)} {drag &&
} {active &&
e.stopPropagation()}> {menu ?
{spot(menu).items.map(item => )}
: {(typing.item + "_1").slice(0, typing.n)}}
} {!drag &&
{caption[0]}{caption[1]}
}
{SPOTS.map(s => )} {SPOTS.map(s => placed[s.id] && )}
{entity && 
{entity}
}
; }; export const PromptDisplay = ({prompt}) => { const [copied, setCopied] = useState(false); const copy = () => { navigator.clipboard.writeText(prompt); setCopied(true); setTimeout(() => setCopied(false), 2000); }; return

{prompt}

; }; export const ImageExamples = ({examples = []}) => { const [copied, setCopied] = useState(null); const [expanded, setExpanded] = useState({}); const [viewer, setViewer] = useState(null); const [actualSize, setActualSize] = useState(false); const openViewer = index => { setActualSize(false); setViewer(index); }; const copyPrompt = async (prompt, index) => { try { await navigator.clipboard.writeText(prompt); setCopied(index); setTimeout(() => setCopied(null), 2000); } catch { setCopied(null); } }; return
{examples.map(({src, alt, label, prompt, zoom, focus = "50% 50%"}, index) =>
{prompt ?

{prompt}

{prompt.length > 240 ? : null}
: label ?
{label}
: null}
)} {viewer !== null ? { if (node && !node.open) node.showModal(); }} onClose={() => setViewer(null)} onClick={() => setViewer(null)}> {examples[viewer].alt} { event.stopPropagation(); setActualSize(!actualSize); }} />
event.stopPropagation()}>
: null}
; };

FLUX 3 Image

FLUX 3 Image Editing

Edit an image with a written instruction, combine up to ten references, and add bounding boxes to place elements or target an edit.

## Quickstart Send an image in `images` and say what to change. This request recolors an owl and keeps the rest of the photo as it was. Drag the handle to compare:
Set `BFL_API_KEY` to a key from the [BFL dashboard](https://dashboard.bfl.ai), then submit: ```python Python theme={null} import os import requests response = requests.post( "https://api.bfl.ai/v1/flux-3-image", headers={"x-key": os.environ["BFL_API_KEY"]}, json={ "prompt": "In this image, change , previously described as \"a short-eared owl in flight with brown and tan mottled feathers and yellow eyes\", to: a short-eared owl in flight with striking snowy white and charcoal grey mottled feathers and bright yellow eyes. Keep everything else in the image — composition, other elements, lighting, background — exactly unchanged.", "images": ["https://cdn.sanity.io/images/2gpum2i6/production/1731db585c799dbb4e2c48731ea0b5bfc92a47d7-1800x1193.webp"], }, timeout=60, ) response.raise_for_status() print(response.json()) ``` ```bash cURL theme={null} curl --fail-with-body https://api.bfl.ai/v1/flux-3-image \ -H "x-key: $BFL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "prompt": "In this image, change , previously described as \"a short-eared owl in flight with brown and tan mottled feathers and yellow eyes\", to: a short-eared owl in flight with striking snowy white and charcoal grey mottled feathers and bright yellow eyes. Keep everything else in the image — composition, other elements, lighting, background — exactly unchanged.", "images": ["https://cdn.sanity.io/images/2gpum2i6/production/1731db585c799dbb4e2c48731ea0b5bfc92a47d7-1800x1193.webp"] }' ``` `aspect_ratio` defaults to `auto`, so the edit keeps the shape of the image you send. Poll the returned `polling_url` until `status` is `Ready`, then download the image from `result.sample` within 1 hour. [FLUX 3 Text to Image](/flux_3/flux3_image_generate#quickstart) has complete clients that submit, poll, and save. ## Edit with an instruction These examples call `generate()` from the [complete clients](/flux_3/flux3_image_generate#quickstart), which submits a request, polls until it is ready, and saves the image. Send the image in `images` and write the change as an instruction. Name the element precisely enough that only one thing in the image matches. This request changes the color of one bird in a flock:
```python theme={null} generate({ "prompt": "change the color of only one bird in the middle to #e01075", "images": ["https://cdn.sanity.io/images/2gpum2i6/production/4792198dfeba9223bf3ecf020fed2942de7f0bd7-1800x1200.webp"], }, name="pink_bird") ``` With `aspect_ratio` left at `auto`, the output keeps the aspect ratio of the image you send. You don't have to draw a box for a single edit. Before it generates, FLUX 3 Image expands your instruction into a detailed prompt, and for many edits it also finds the element you named and adds a box for it. The expanded prompt, including any boxes it added, comes back in `result.prompt`. To control exactly which elements change, use [bounding boxes](/flux_3/flux3_image_bounding_boxes#edit-an-image). ## Multi reference Refer to each image by its position or by what it shows. "Image 1" is the first entry in `images`, "image 2" the second, and so on up to ten. Here, image 1 is the scene and image 2 supplies the object to place in it: ```python theme={null} generate({ "prompt": "replace the cartridge from image 1 with the van in image 2, adjust the lighting on the van to integrate well within image 1", "images": [ "https://cdn.sanity.io/images/2gpum2i6/production/ec365238b6efa1b29f573e83b774c6d539408ea8-1800x1200.webp", "https://cdn.sanity.io/images/2gpum2i6/production/ff3bf81b5a8b38f0d870561217b68a72964259ab-1131x1414.webp", ], }, name="turntable_van") ``` With `aspect_ratio` at `auto`, the output uses the aspect ratio of the first image in `images`. The turntable is first, so the result is landscape. For a different shape, put a different image first or set `aspect_ratio`. For product shots, try-ons, and group compositions, say how the images relate: "the person from image 1 wears the jacket from image 2 and stands in the kitchen from image 3". ## Examples Each example shows the inputs, the result, and the prompt that produced it. ### Single Image Reference Send one image and write the change as an instruction. Drag the handle to compare:
### Multi Image Reference Refer to each image by its position in `images`. The output keeps the aspect ratio of image 1. **Replace an object with a new design** **Add elements from several images** **Furnish a room** ### Edit with Bboxes Each edit changes one boxed element and anchors the rest. Select an example, then switch between before and after. ## Send a request Copy a request body from the [bounding box examples](/flux_3/flux3_image_bounding_boxes#examples) and paste it where indicated below, including its outer braces. To adapt an edit to your image, update the image URL, element descriptions, and source and target boxes. ```python Python theme={null} import json body = r''' Paste the complete copied JSON body here. ''' generate(json.loads(body)) ``` ```bash cURL theme={null} curl --fail-with-body https://api.bfl.ai/v1/flux-3-image \ -H "x-key: $BFL_API_KEY" \ -H "Content-Type: application/json" \ -d @- <<'EOF' Paste the copied request body here. EOF ``` `generate()` is defined in the [complete clients](/flux_3/flux3_image_generate#quickstart). It submits the request, polls until the image is ready, and saves it. With cURL, poll the returned `polling_url` until `status` is `Ready`, then download `result.sample`. Use the aspect ratio you designed the layout for, because the grid stretches with the frame. For edits, `auto` follows the first reference; without a reference, it produces a square. ```python theme={null} def to_bbox(left, top, right, bottom, width, height): return [round(top / height * 1000), round(left / width * 1000), round(bottom / height * 1000), round(right / width * 1000)] to_bbox(384, 108, 1536, 972, 1920, 1080) # [100, 200, 900, 800] ``` To move or resize an element, use different source and target boxes. Use matching boxes to ask for it to stay in place. State additions and removals in the written instruction as well as the rows. Very small boxes can fail. In our tests, a new element in a box about 40 × 25 pixels often did not appear, so give new elements a larger box. Give text its own box and quote the words in `desc`. See [Layout prompts](/guides/prompting_layout) for more examples. Draw over a marked region, or choose one below the image, then select an object. This demo uses saved edits and makes no API requests. Pixels outside the boxes usually stay the same. Shadows, reflections, or nearby lighting may still change. Compare each input with its edit. Switch to Changed pixels to see which areas the edit touched. ## Keep exploring Complete clients that submit, poll, and save, plus edits and multi-reference requests. The full request schema, limits, and response codes. How to write the caption and element table for a layout.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.