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

# ComfyUI 中的 FLUX 3 Image：文生图与图像编辑

> 在 ComfyUI 中使用 FLUX 3 Image 完成文生图、多参考图编辑和边界框版式控制，最高支持 4K，并默认启用网络搜索 grounding。

FLUX 3 是 Black Forest Labs 的多模态基础模型，于 2026 年 7 月 23 日发布，目前处于 Early Access 阶段。它在一个基于 Self-Flow 的统一架构中同时学习图像、视频和音频。Self-Flow 是他们在同一个模型中对齐多模态生成与理解的方法。FLUX 3 Image 是其中负责生成和编辑静态图像的部分。在 Early Access 推进期间，其能力和限制可能会发生变化。

FLUX 3 Image 可以把一段文本提示词变成图像，也可以编辑并组合最多 10 张参考图像。你在提示词中以 `image 1`、`image 2` 这样的方式引用这些图像，模型会先解读并扩写提示词，再开始生成。网络与图像搜索 grounding 默认开启，因此它可以查询你提到的对象。它会返回单张图像，支持十六种宽高比和五档分辨率，从 0.75K（约 0.6 百万像素）到 4K（约 16.8 百万像素）。

在 ComfyUI 中，FLUX 3 Image 通过 **Flux 3 Image** 合作伙伴节点运行，按分辨率以积分计费，每张图像一次。共有三个模板，分别覆盖文生图、多参考图编辑和边界框版式控制。

## FLUX 3 Image 擅长什么

* **文生图**：根据一段提示词生成一张图像，模型会先解读并扩写提示词
* **多参考图编辑**：编辑或组合最多 10 张参考图像，在提示词中以 `image 1` 到 `image 10` 引用
* **边界框版式控制**：用 Create Bounding Boxes 节点生成的方框，把对象和文字放到你想要的位置
* **搜索 grounding**：网络与图像搜索默认开启，模型可以在绘制前查询你提到的对象
* **灵活输出**：支持十六种宽高比和五档分辨率，从 0.75K 到 4K
* **文字排版与版式**：适合海报、标题、字幕以及以版式为核心的设计工作

## 使用方式

<Card title="从代码调用" icon="code" href="/zh/development/comfy-router/models/black-forest-labs/flux-3-image/code">
  通过 Comfy Router 以 HTTP 方式调用，附带可直接复制粘贴的 Python、TypeScript、Swift 和 cURL 代码片段
</Card>

它运行在同一个 Comfy 账户上，计费所使用的积分与下方在 ComfyUI 中运行完全相同。各分辨率的费率请参见[合作伙伴节点积分](/zh/tutorials/partner-nodes/pricing)，可同时在途的请求数量请参见[并发限制](/zh/tutorials/partner-nodes/concurrency-limits)。

<Tip>
  使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](/zh/tutorials/partner-nodes/overview)部分文档来了解使用 API 节点的具体使用要求。
</Tip>

<Tip>
  <Tabs>
    <Tab title="本地用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新版（每夜版）。
      2. 启动时有些节点导入失败。
    </Tab>

    <Tab title="云端用户">
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新。

      所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。
    </Tab>
  </Tabs>
</Tip>

## FLUX 3 Image 文生图工作流

根据文本提示词生成图像。FLUX 3 Image 会解读并扩写提示词，然后按你选择的分辨率渲染。无需任何输入文件。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_bfl_flux3_t2i-1.webp" alt="FLUX 3 Image 文生图工作流" />

<CardGroup cols={2}>
  <Card title="在 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">
    在 Comfy Cloud 中打开
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_bfl_flux3_t2i.json">
    下载 JSON，或在模板库中搜索“Flux 3 Image: Text to Image”
  </Card>
</CardGroup>

### 文生图运行步骤

1. 在 **Flux 3 Image** 节点中输入提示词
2. 设置 `resolution`（0.75K 到 4K），如需自定义可把 `aspect_ratio` 设为 `auto` 以外的值
3. 保持 `grounding` 开启，让模型为你提到的对象检索网络和图像
4. 点击 **Queue** 生成图像

## FLUX 3 Image 图像编辑工作流

根据一段文本指令编辑一张图像，或组合多张图像。连接最多 10 张参考图像，并在提示词中以 `image 1`、`image 2` 这样的方式命名它们。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_bfl_flux3_image_edit-1.webp" alt="FLUX 3 Image 图像编辑工作流" />

<CardGroup cols={2}>
  <Card title="在 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">
    在 Comfy Cloud 中打开
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_bfl_flux3_image_edit.json">
    下载 JSON，或在模板库中搜索“FLUX.3 Image: Image Edit”
  </Card>
</CardGroup>

<details className="prose" style={{marginBottom:"1rem"}}>
  <summary>输入素材</summary>

  下载以下示例输入图像来试用该工作流：

  <CardGroup cols={1}>
    <Card title="输入图像" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/fashion_model_green_pilot_coat.png">
      下载示例输入图像
    </Card>
  </CardGroup>
</details>

### 图像编辑运行步骤

1. 把你的参考图像上传到 **Load Image** 节点，通过 Autogrow 插槽继续添加，最多 10 张
2. 在 **Flux 3 Image** 节点中描述编辑内容，把每张参考图命名为 `image 1`、`image 2` 等
3. 设置输出的 `resolution` 和 `aspect_ratio`
4. 点击 **Queue** 生成编辑后的图像

## FLUX 3 Image 边界框编辑工作流

把 **Create Bounding Boxes** 节点生成的方框接入 **Flux 3 Image** 节点，即可把对象和文字放到精确位置。方框坐标相对于画布，因此输出的宽高比要与画布一致。每个方框自带描述，会一并加入提示词。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_bfl_flux3_image_bboxes-1.webp" alt="FLUX 3 Image 边界框编辑工作流" />

<CardGroup cols={2}>
  <Card title="在 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">
    在 Comfy Cloud 中打开
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_bfl_flux3_image_bboxes.json">
    下载 JSON，或在模板库中搜索“Flux.3 Image: Bounding Box Edit”
  </Card>
</CardGroup>

<details className="prose" style={{marginBottom:"1rem"}}>
  <summary>输入素材</summary>

  下载以下示例输入图像来试用该工作流：

  <CardGroup cols={1}>
    <Card title="输入图像" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/giant_flamingo_balloon_ship_harbor.png">
      下载示例输入图像
    </Card>
  </CardGroup>
</details>

### 边界框编辑运行步骤

1. 把图像上传到 **Load Image** 节点
2. 用 **Create Bounding Boxes** 绘制方框，并给每个方框写一段描述
3. 在 **Flux 3 Image** 节点中写下整体指令
4. 把 `aspect_ratio` 设为与绘制方框时所用画布一致
5. 点击 **Queue** 生成图像

## 开始使用

1. 将 ComfyUI 更新至最新版本（0.38.2 或更高）
2. 打开模板库，搜索 `Flux 3 Image`


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