> ## 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 Klein ComfyUI 指南

> 在 ComfyUI 本地运行 FLUX.3 [klein]：开源权重文生图与指令驱动图像编辑，并提供 4–16 步的蒸馏版快速采样。

## 关于 FLUX.3 \[klein]

FLUX.3 \[klein] 是 Black Forest Labs 面向本地 ComfyUI 的开源权重 FLUX.3 图像模型：同一系列同时覆盖文生图与指令驱动的图像编辑，并提供完整版与步数蒸馏版（约 4–16 步、无需引导）。权重以 FLUX Kommunity License 发布在 Hugging Face — 下载一次后即可在自己的 GPU 上运行，无需 API 密钥，也不按张计费。

如果更想用托管路径，FLUX.3 也可通过合作伙伴节点 [FLUX 3 Image](/zh/tutorials/partner-nodes/black-forest-labs/flux-3-image) 运行（按图像计费）。本地 GPU 用 klein 权重；不想下载时用合作伙伴节点。

**模型亮点：**

* 文生图与图像编辑共用同一份权重；编辑由指令提示词加参考图驱动
* 两个 checkpoint：完整版 Flux.3 Image Klein，以及无需引导、4–16 步采样的 Distilled
* 多参考图提示：在提示词中用 `<ref_image_0>`、`<ref_image_1>` 等引用
* 可选 Qwen3.5 9B 提示词上采样器，生成前把短请求扩成完整描述
* 单文件 checkpoint，支持 bf16、int8（convrot）、nvfp4，搭配 Qwen3-VL-4B 文本编码器与 Flux 2 VAE

**许可证**：[FLUX Kommunity License](https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy/blob/main/LICENSE.md)

**版本要求**：Flux.3 Klein 模板需要 ComfyUI 0.41.0 或更高版本（随 0.41.1 向后移植发布，ComfyUI#17070）。

<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 Klein 工作流

<h3 id="image_flux3_klein_t2i">
  Flux.3 Image Klein：文本到图像
</h3>

仅凭提示词生成图像，无需任何输入文件。该工作流是一个子图：打开它即可访问加载器、采样器和画布尺寸。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_flux3_klein_t2i-1.webp" alt="Flux.3 Image Klein 文本到图像工作流预览" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 上运行" icon="cloud" href="https://cloud.comfy.org/?template=image_flux3_klein_t2i&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-klein">
    在 Comfy Cloud 中打开
  </Card>

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

1. 在子图的正向提示词组件中输入你的提示词
2. 设置 `width` 和 `height`，或者从 `ResolutionSelector` 中选择一个画幅（默认为 1:1 正方形）
3. 调整 `steps`（默认 25）和 `cfg`（默认 3.5）。模板中附有一条备注，建议尝试 50 步以获得更好的质量
4. 保持 `enable_prompt_upsampler` 关闭，则根据你自己的文字生成；开启后，会先用 Qwen3.5 9B 上采样器扩展提示词
5. 点击 **Queue**。图像由 `SaveImage` 节点保存到 `ComfyUI/output/`

<h3 id="image_flux3_klein_distilled_t2i">
  Flux.3 Image Klein 蒸馏版：文生图
</h3>

使用步数蒸馏版 checkpoint 根据提示词生成图像，它无需引导即可在 15 步内完成。此处默认开启提示词上采样，因此简短的提示词会在采样前被扩展为完整的描述。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_flux3_klein_distilled_t2i-1.webp" alt="Flux.3 Image Klein 蒸馏版文生图工作流预览" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 上运行" icon="cloud" href="https://cloud.comfy.org/?template=image_flux3_klein_distilled_t2i&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-klein">
    在 Comfy Cloud 中打开
  </Card>

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

1. 输入提示词。模板会先对其进行上采样，因此简短的描述即可
2. 将 `steps` 设置在 4 到 16 之间（默认为 15）。蒸馏版 checkpoint 以 `cfg` 1 运行，因此提高 `cfg` 没有帮助
3. 从 `ResolutionSelector` 中选择一个画幅
4. 点击 **Queue** 生成

**示例输出**

![Flux.3 Image Klein 蒸馏版文生图示例](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux3_klein_distilled_t2i.png)

<h3 id="image_flux3_klein_image_edit">
  Flux.3 Image Klein：图像编辑
</h3>

根据指令提示词编辑照片，并将原始图像作为参考连接。指令会替换参考内容：此处提示词将连衣裙颜色改为红色，其余内容保持不变。

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

<CardGroup cols={2}>
  <Card title="Run on Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=image_flux3_klein_image_edit&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-klein">
    在 Comfy Cloud 中打开
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_flux3_klein_image_edit.json">
    下载 JSON，或在模板库中搜索 "Flux.3 Image Klein: Image Edit"
  </Card>
</CardGroup>

**输入素材**

将此文件上传到对应的 `LoadImage` 节点：

<CardGroup cols={2}>
  <Card title="fashion_portrait_blue_silk_gown_vis.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/fashion_portrait_blue_silk_gown_vis.png">
    `LoadImage` 节点 11 · `fashion_portrait_blue_silk_gown_vis.png`
  </Card>
</CardGroup>

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/fashion_portrait_blue_silk_gown_vis.png" alt="fashion_portrait_blue_silk_gown_vis.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

1. 在 `LoadImage` 节点中加载来源图像
2. 将其连接到 `Set Reference Multi Latent`。第一个参考在提示词中为 `<ref_image_0>`，下一个为 `<ref_image_1>`，依此类推
3. 将编辑内容写为对结果的完整描述。在随附的示例中，正向提示词为 `change the dress color to red`
4. 如果想要不同的输出尺寸，可使用 `Empty Flux 2 Latent` 调整画布（模板中为 1024 x 1024）
5. 点击 **队列**。`ImageCompare` 会并排显示输入和结果

**示例输出**

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/fashion_portrait_blue_silk_gown_vis.png" alt="输入图像" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />

  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux3_klein_image_edit.png" alt="Flux.3 Image Klein 图像编辑示例输出" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

<h3 id="image_flux3_klein_distilled_image_edit">
  Flux.3 Image Klein Distilled：图像编辑
</h3>

使用步数蒸馏的 checkpoint 编辑图像：一张参考图像、一条指令提示词、16 步，且不使用引导。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_flux3_klein_distilled_image_edit-1.webp" alt="Flux.3 Image Klein Distilled 图像编辑工作流预览" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 上运行" icon="cloud" href="https://cloud.comfy.org/?template=image_flux3_klein_distilled_image_edit&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-klein">
    在 Comfy Cloud 中打开
  </Card>

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

**输入素材**

将此文件上传到对应的 `LoadImage` 节点：

<CardGroup cols={2}>
  <Card title="woman_gold_earring_teal_top_portrait.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/woman_gold_earring_teal_top_portrait.png">
    `LoadImage` 节点 11 · `woman_gold_earring_teal_top_portrait.png`
  </Card>
</CardGroup>

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/woman_gold_earring_teal_top_portrait.png" alt="woman_gold_earring_teal_top_portrait.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

1. 加载要编辑的图像，并将其连接到 `Set Reference Multi Latent`
2. 编写编辑提示词。随附的示例会替换耳环，并详细描述新的耳环，包括哪些内容不能出现
3. 将 `steps` 保持在 4 到 16 的范围内，并将 `cfg` 保持为 1
4. 点击 **队列**，在 `ImageCompare` 中对比输入与结果

## Flux.3 Image Klein 模型下载

<Note>
  Flux.3 Klein 的权重存放在需要同意许可的仓库 [black-forest-labs/flux-3-image-klein-comfy](https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy)。打开该页面，接受许可协议，然后下载文件。模板使用 int8（convrot）单文件 checkpoint；同一仓库中还有相同 checkpoint 的 bf16 和 nvfp4 版本。
</Note>

<CardGroup cols={2}>
  <Card title="flux3_image_klein_int8_convrot.safetensors" icon="download" href="https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy">
    扩散模型，完整的 Flux.3 Image Klein checkpoint。
  </Card>

  <Card title="flux3_image_klein_sd_int8_convrot.safetensors" icon="download" href="https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy">
    扩散模型，适用于 4 到 16 步的步数蒸馏版 checkpoint。
  </Card>

  <Card title="qwen3vl_4b_int8_convrot.safetensors" icon="download" href="https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy">
    两个 checkpoint 共用的文本编码器。使用 `CLIPLoader` 类型 `flux3` 加载。
  </Card>

  <Card title="qwen3.5_9b_flux3_prompt_upsampler_int8_convrot.safetensors" icon="download" href="https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy">
    文生图模板使用的提示词上采样器。
  </Card>

  <Card title="flux2-vae.safetensors" icon="download" href="https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy">
    Flux.3 Klein 的 VAE，即 Flux 2 VAE。
  </Card>
</CardGroup>

**模型存放位置**

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │      ├── flux3_image_klein_int8_convrot.safetensors
│   │      └── flux3_image_klein_sd_int8_convrot.safetensors
│   ├── 📂 text_encoders/
│   │      ├── qwen3vl_4b_int8_convrot.safetensors
│   │      └── qwen3.5_9b_flux3_prompt_upsampler_int8_convrot.safetensors
│   └── 📂 vae/
│          └── flux2-vae.safetensors
```

## 提示词与参考图技巧

* **写出结果，而不是改动。** 图像编辑模板期望得到的是一段对最终图像的完整描述，并把编辑融入其中，这正是示例会详细描述新对象、而不是说"把这里改一下"的原因。
* **参考图会被加入两个条件中。** 按顺序把额外图像连接到 `Set Reference Multi Latent`，用 `<ref_image_0>`、`<ref_image_1>` 等来引用它们，并像参考 pipeline 那样把每一张同时加入正面和负面提示词。
* **参考图尺寸是一档成本调节。** 模板会把每张参考图调整大小到约 100 万像素，输出 Latent 也采用该尺寸。保持参考图的原始尺寸（Black Forest Labs 自家的 pipeline 最高可到约 1600 万像素）能让编辑保留更多细节，但成本也更高。
* **步数取决于 checkpoint。** 在模板中，完整 checkpoint 以 25 步、引导 3.5 运行，并附有可尝试 50 步以获得更好质量的提示。步数蒸馏版 checkpoint 以 15 或 16 步运行，引导固定为 1，想要快速跑一遍时就用它。
* **模板自带 `Create Bounding Boxes` 节点。** 它会在来源图像上绘制边界框，用于规划区域编辑，其边界框列表显示在 `Preview Any` 节点中，方便你把这些区域融入提示词。


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