> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# FLUX 3 Image in ComfyUI: Text to Image and Image Edit

> Run FLUX 3 Image in ComfyUI for text-to-image generation, multi-reference edits, and bounding-box layout control, at up to 4K with web search grounding.

FLUX 3 is Black Forest Labs' multimodal foundation model, announced July 23, 2026 and in Early Access. It learns from images, video, and audio in a single architecture built on Self-Flow, their approach to aligning multimodal generation and understanding in one model. FLUX 3 Image is the part of it that generates and edits still images. Capabilities and limits may change during the Early Access rollout.

FLUX 3 Image turns a text prompt into an image, or edits and combines up to 10 reference images. You refer to the references in the prompt as `image 1`, `image 2`, and so on, and the model interprets and expands the prompt before generating. Web and image search grounding is on by default, so it can look up the subjects you name. It returns a single image at any of sixteen aspect ratios and at one of five resolution tiers, from 0.75K (about 0.6 megapixels) up to 4K (about 16.8 megapixels).

In ComfyUI, FLUX 3 Image runs through the **Flux 3 Image** Partner Node and is billed in credits per generated image, by resolution. Three templates cover text-to-image, multi-reference editing, and bounding-box layout control.

## What FLUX 3 Image is good at

* **Text to image**: generates one image from a prompt, which the model interprets and expands first
* **Multi-reference editing**: edits or combines up to 10 reference images, addressed as `image 1` to `image 10` in the prompt
* **Bounding-box layout control**: places objects and text where you want them with boxes from the Create Bounding Boxes node
* **Search grounding**: web and image search are on by default, so the model can research named subjects before it draws
* **Flexible output**: sixteen aspect ratios and five resolution tiers, from 0.75K to 4K
* **Typography and layout**: suited to posters, headlines, captions, and layout-driven design work

## Use it

<Card title="Call it from code" icon="code" href="/development/comfy-router/models/black-forest-labs/flux-3-image/code">
  Call it over HTTP through Comfy Router, with copy-paste Python, TypeScript, Swift and cURL snippets
</Card>

This runs on the same Comfy account and is billed in the same credits as running it in ComfyUI below. See [Partner Nodes pricing](/tutorials/partner-nodes/pricing) for per-resolution rates and [Concurrency limits](/tutorials/partner-nodes/concurrency-limits) for how many requests you can have in flight.

<Tip>
  To use the Partner Nodes, you need to ensure that you are logged in properly and using a permitted network environment. Please refer to the [Partner Nodes Overview](/tutorials/partner-nodes/overview) section of the documentation to understand the specific requirements for using the Partner Nodes.
</Tip>

<Tip>
  <Tabs>
    <Tab title="Local users">
      Make sure your ComfyUI is updated.

      * [Download ComfyUI](https://www.comfy.org/download)
      * [Update Guide](/installation/update_comfyui)

      Workflows in this guide can be found in the [Workflow Templates](/interface/features/template).
      If you can't find them in the template, your ComfyUI may be outdated.

      If nodes are missing when loading a workflow, possible reasons:

      1. You are not using the latest ComfyUI version (Nightly version)
      2. Some nodes failed to import at startup
    </Tab>

    <Tab title="Cloud users">
      * [Cloud](https://cloud.comfy.org) will update after ComfyUI stable release.

      So, if you find any core node missing in this document, it might be because the new core nodes have not yet been released in the latest stable version. Please wait for the next stable release.
    </Tab>
  </Tabs>
</Tip>

## FLUX 3 Image text-to-image workflow

Generate an image from a text prompt. FLUX 3 Image interprets and expands the prompt, then renders it at the resolution you choose. No input files are required.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_bfl_flux3_t2i-1.webp" alt="FLUX 3 Image text to image workflow" />

<CardGroup cols={2}>
  <Card title="Run on Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=api_bfl_flux3_t2i&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-image">
    Open in Comfy Cloud
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_bfl_flux3_t2i.json">
    Download JSON or search "Flux 3 Image: Text to Image" in Template Library
  </Card>
</CardGroup>

### Text to image steps

1. Enter a prompt in the **Flux 3 Image** node
2. Set `resolution` (0.75K to 4K) and, if you want, an `aspect_ratio` other than `auto`
3. Leave `grounding` on to let the model search the web and images for the subjects you name
4. Click **Queue** to generate the image

## FLUX 3 Image edit workflow

Edit an image, or combine several, from a text instruction. Connect up to 10 reference images and name them in the prompt as `image 1`, `image 2`, and so on.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_bfl_flux3_image_edit-1.webp" alt="FLUX 3 Image edit workflow" />

<CardGroup cols={2}>
  <Card title="Run on Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=api_bfl_flux3_image_edit&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-image">
    Open in Comfy Cloud
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_bfl_flux3_image_edit.json">
    Download JSON or search "FLUX.3 Image: Image Edit" in Template Library
  </Card>
</CardGroup>

<details className="prose" style={{marginBottom:"1rem"}}>
  <summary>Input materials</summary>

  Download this sample input image to try the workflow:

  <CardGroup cols={1}>
    <Card title="Input image" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/fashion_model_green_pilot_coat.png">
      Download sample input image
    </Card>
  </CardGroup>
</details>

### Image edit steps

1. Upload your reference images to the **Load Image** node, adding more with the Autogrow slots, up to 10
2. Describe the edit in the **Flux 3 Image** node, naming each reference as `image 1`, `image 2`, and so on
3. Set `resolution` and `aspect_ratio` for the output
4. Click **Queue** to generate the edited image

## FLUX 3 Image bounding box edit workflow

Place objects and text at exact positions by feeding boxes from the **Create Bounding Boxes** node into the **Flux 3 Image** node. Boxes are relative to the canvas, so set the output to the same aspect ratio. Each box carries its own description, which joins the prompt.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_bfl_flux3_image_bboxes-1.webp" alt="FLUX 3 Image bounding box edit workflow" />

<CardGroup cols={2}>
  <Card title="Run on Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=api_bfl_flux3_image_bboxes&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-image">
    Open in Comfy Cloud
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_bfl_flux3_image_bboxes.json">
    Download JSON or search "Flux.3 Image: Bounding Box Edit" in Template Library
  </Card>
</CardGroup>

<details className="prose" style={{marginBottom:"1rem"}}>
  <summary>Input materials</summary>

  Download this sample input image to try the workflow:

  <CardGroup cols={1}>
    <Card title="Input image" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/giant_flamingo_balloon_ship_harbor.png">
      Download sample input image
    </Card>
  </CardGroup>
</details>

### Bounding box edit steps

1. Upload the image to the **Load Image** node
2. Draw boxes with **Create Bounding Boxes** and give each one a description
3. Write the overall instruction in the **Flux 3 Image** node
4. Set `aspect_ratio` to match the canvas the boxes were drawn on
5. Click **Queue** to generate the image

## Get started

1. Update ComfyUI to the latest version (0.38.2 or later)
2. Open Template Library and search for `Flux 3 Image`


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