Flux 3 Image: the complete guide

Flux 3 Image: the complete guide

Learn how to use Flux 3 Image: how to write a prompt, layout prompts with bounding boxes, edit instructions, combining up to 10 references, box-by-box edits, and resolution settings.

What Flux 3 Image adds

Flux 3 Image, released by Black Forest Labs on October 1, 2026, generates and edits from one endpoint. It adds four controls, and the rest of this guide takes them one at a time. Black Forest Labs documents each in its Flux 3 Image docs.

ControlWhat it doesReach for it when
Bounding boxesPlaces each element on a 0 to 1000 gridPosition is part of the brief
Edit instructionsChanges what you name, keeps the restOne detail is wrong
Up to 10 referencesCombines images by their positionA real product, person, or room must appear
Up to 4K outputFive sizes from a 768 px draft to 4KThe image goes to print or gets cropped

How to write a Flux 3 Image prompt

Describe the medium, the subject, the setting, the light, and the framing, in that order. Say what should be there rather than what should not: "an empty street" works better than "a street with no cars".

A wide editorial photograph of an empty reading room with tall oak shelves and low winter sun through high windows
Medium, subject, light, framing

An editorial photograph of an empty public reading room: tall oak shelves along both walls, long tables with green-shaded lamps, low winter sun falling through high arched windows in long beams. Wide shot at eye level, 35mm, quiet and warm.

Layout prompts with bounding boxes in Flux 3 Image

A layout prompt has two parts: a caption that tags each element with a short id, then one row per id with a box and a description. Boxes run top, left, bottom, right, from 0 to 1000 on each axis, so the same numbers work at any aspect ratio. Set the aspect ratio first, and give each block of text its own row.

PartWhat goes in itExample
CaptionThe scene, with an id after each elementA swimmer <swimmer_1> under a title <title_1>
idShort, lowercase, numberedswimmer_1, title_1
bboxTop, left, bottom, right on 0 to 1000[620, 380, 900, 620]
descLook, color, pose, and exact wordsText reading "NIGHT TIDE" in cream capitals
A vertical poster with the words NIGHT TIDE in tall cream capitals at the top and a lone swimmer in dark water below
Caption and rows
A screen-printed poster on textured paper. The title <title_1> runs across the top in tall cream capitals. Below it, a lone swimmer <swimmer_1> crosses dark teal water <water_1>, seen from above, leaving a pale wake. [ {"id": "title_1", "bbox": [60, 100, 260, 900], "desc": "Text reading \"NIGHT TIDE\" in tall condensed cream capitals, centered"}, {"id": "water_1", "bbox": [300, 0, 1000, 1000], "desc": "Dark teal water with fine printed grain"}, {"id": "swimmer_1", "bbox": [560, 380, 820, 620], "desc": "A swimmer in a white cap mid-stroke, arms forward, a pale V-shaped wake behind"} ]

Editing with Flux 3 Image: one instruction, three parts

There is no mask or edit mode. Send the image and write the change as an instruction: name the target, give the change, then list what stays. When the exact value matters, write it: a hex code for a color, the words in quotes for text.

Before and after of four bicycles parked against a white wall, only the third bicycle recolored mint green
Target, change, what stays

Change the frame of the third bicycle from the left to mint green #98D7C2. Keep the other three bicycles, the white wall, the cobblestones, the shadows and the framing exactly the same.

Before and after of a small shop front, a plain green awning now lettered BOOKS & COFFEE in white serif capitals
Exact words

Change the awning text to "BOOKS & COFFEE" in white serif capitals, centered on the awning. Keep the shop front, the window display and the street exactly the same.

Combining up to 10 references in Flux 3 Image

Refer to each image by its position and give it one job. Flux 3 Image reads them in order, and the output takes the shape of image 1 unless you set an aspect ratio.

RoleWhat it suppliesHow to say it
SettingThe room or place everything goes intothe living room in image 1
ProductAn object whose shape and finish must holdthe armchair from image 2
MaterialA color, fabric, or textureupholstered in the fabric from image 3
SubjectA person or animal to keep recognizablethe woman in image 4
A bright living room, a wingback armchair, and a mustard bouclé swatch as inputs, combined into one image of the chair in the room
Three images, three roles

Place the armchair from image 2 by the window in the living room from image 1, upholstered in the mustard fabric from image 3. Light it from the window on the left so it matches the room. Keep the room exactly as it is.

Edit box by box: keep, move, new, remove

When an edit must hit one exact element, describe the source image with rows too. Each row says where an element is now and where it should end up, which tells the model what to keep, what to move, and what to make new.

RowHow to write itEffect
KeepSame box before and afterStays exactly where it is
MoveOld box, then a new boxMoves or resizes the element
NewNo source, a target box and a descriptionAdds, replaces, or recolors in that box
RemoveIts box, then no targetTakes it out and fills the space
Before and after of a valley at sunrise, a single striped hot-air balloon moved from the center to the upper left
Move one element

In image 1, move the striped hot-air balloon from the center of the sky to the upper left. Keep the valley, the river, the morning mist and the light exactly the same.

Flux 3 Image resolution, aspect ratio, and grounding

Draft small, finish large. A new resolution is a new generation, so the composition can shift between a draft and the final.

SettingOptionsWhat to do
Resolution768 px square, 1K, 1.5K, 2K, 4KTest at 768 px, finish at 2K or 4K
Aspect ratio15 ratios, 21:9 to 9:21, plus autoPick it before drawing boxes
Auto ratioFollows image 1, else squareLeave it on for edits
GroundingWeb and image search, on by defaultTurn it off for faster drafts
Open weightsCommercial license now, open laterWatch Black Forest Labs for the release

FAQs

How do I write a good Flux 3 Image prompt?

Describe the medium, the subject, the setting, the light, and the framing, in that order, and phrase everything positively: "an empty street" rather than "no cars". Make the prompt and the aspect ratio agree; a wide frame needs something to fill its width.

How do bounding boxes work in Flux 3 Image?

Each box is four numbers, top, left, bottom, right, on a 0 to 1000 grid that stays the same at any aspect ratio. Tag each element in the caption with an id such as swimmer_1, then add one row per id with its box and a description.

Do I need bounding boxes to edit with Flux 3 Image?

No. Start with a written instruction. Add box rows when several similar objects match the wording, when a change needs an exact position or size, or when you want to move or remove one specific element.

How do I refer to reference images in Flux 3 Image?

By position: image 1, image 2, and so on, up to 10. Give each one a role, such as the setting, the product, or the material, and say how they fit together.

Can Flux 3 Image put exact text in an image?

Yes. Quote the words and name the case, color, typeface style, and alignment. In a layout prompt, give each block of text its own row and box.

What resolution should I use in Flux 3 Image?

Draft at the 768 px square size while you work on the prompt, then render the keeper at 2K or 4K. The 1K default suits most web images.

When can I use Flux 3 Image on Morphic?

Flux 3 Image is coming to Morphic. The edit and multi-reference prompts in this guide already work with the image models on Morphic today, which is how every example on this page was made.