> ## 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

> Generate images from text, edit specific details, and combine up to ten references with FLUX 3 Image.

FLUX 3 Image
Overview
FLUX 3 Image gives you maximum control over every pixel. Generate an image from a prompt, edit specific details, combine up to ten references, and draw bounding boxes to place each element.
[Open API reference](https://docs.bfl.ml/api-reference/utility/generate-an-image-with-flux-3.md)

## Capabilities

Write a prompt to generate a new image. Add up to ten reference images and describe how to use them: edit a detail,
change the style, or combine them into a new composition. Click any image to view it full size.

### Text to image

Describe the subject, setting, light, and framing. FLUX 3 renders the
whole scene from the prompt.

Previous clip

Next clip

[Generate your first image →](https://docs.bfl.ml/flux_3/flux3_image_generate.md#text-to-image)

### Edit an image

Write the change as an instruction, and name exactly what to change. Drag the
handle to compare each source with its edit:

Previous clip

Next clip

[Perfectly edit your images →](https://docs.bfl.ml/flux_3/flux3_image_layout.md#edit-with-an-instruction)

### Multi reference

Refer to each image by its position and say what it contributes. Here,
image 1 is the scene and image 2 supplies the object to place in it:

![FLUX 3 Image result: a miniature van in place of the cartridge](https://cdn.sanity.io/images/2gpum2i6/production/0fc855dcc110a26d1689f1fd70005f4f80d58ce2-1800x1193.webp)

Result

prompt:

[Combine up to ten images →](https://docs.bfl.ml/flux_3/flux3_image_layout.md#multi-reference)

### Control the composition

Add bounding boxes to the end of the prompt to decide where each element
goes. Each box is `[top, left, bottom, right]` on a 0 to 1000 grid. These
images from the FLUX 3 launch were generated from layout prompts, with their
boxes drawn on top.

Previous clip

Next clip

The same boxes let you edit only part of an image: recolor, move, replace, or
remove one element while the rest stays unchanged.
[Learn to use bounding boxes →](https://docs.bfl.ml/flux_3/flux3_image_bounding_boxes.md)

### Ground the prompt

By default, FLUX 3 searches the web to get real things right. Set `grounding`
to `false` for faster results that use only your prompt.

![Two Oktoberfest posters. Left, with grounding off: an invented vintage poster of riders on horses, dated 2025. Right, with grounding on: the official 2026 poster with the Frauenkirche towers, a Ferris wheel and a beer stein, dated 19.9. to 4.10.2026.](https://mintcdn.com/bfl/uV8o4_J7ma5eIAOv/images/flux3-image/grounding/oktoberfest-grounding-ab.webp?fit=max\&auto=format\&n=uV8o4_J7ma5eIAOv\&q=85\&s=75bef59176283714f49f9426dfec807b)

Left: grounding off. Right: grounding on.

```diff theme={null}
 {
   "prompt": "A photograph of this year's official Oktoberfest poster",
-  "grounding": false
+  "grounding": true
 }
```

## Keep exploring

> [card] [Try in Playground](https://playground.bfl.ai)
>
> Try FLUX 3 Image in your browser, with no code.

> [card] [FLUX 3 Text to Image](https://docs.bfl.ml/flux_3/flux3_image_generate.md)
>
> Your first request in Python, JavaScript, or cURL, then edits and
> multi-reference compositions.

> [card] [Prompting guide](https://docs.bfl.ml/guides/prompting_summary.md)
>
> How to structure prompts for scenes, styles, text, and edits.

> [card] [Bounding boxes](https://docs.bfl.ml/flux_3/flux3_image_bounding_boxes.md)
>
> Place each element with a box, then edit box by box.

> [card] [API reference](https://docs.bfl.ml/api-reference/utility/generate-an-image-with-flux-3.md)
>
> The full request schema, limits, and response codes.

> [card] [FLUX 3 Image Editing](https://docs.bfl.ml/flux_3/flux3_image_layout.md)
>
> Place elements and target edits with bounding boxes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.