本地部署指南

如何在 ComfyUI 里运行 FLUX 3 Klein

FLUX 3 Klein 既开放权重,也有 ComfyUI 模板,可以放在自己的显卡上跑,不需要 API Key,也没有按张计的积分。下面写清装什么、文件放哪里、四个自带工作流有什么区别,以及许可证允许什么。

本地 ComfyUI,还是在浏览器里跑

本地 ComfyUI 能把整个流程留在自己机器上:提示词、参考图和输出文件都不离开你的硬盘,也不按张收费。但它的配置成本最高,因为模板对 ComfyUI 版本、五个文件和每个任务对应的 checkpoint 都有要求。

如果只是想看看模型对手上的提示词有什么反应,完全可以跳过安装。本站用服务器跑 FLUX 3 Klein,支持最多三张参考图,在这里写一条提示词,一分钟内就能看到结果。

0 / 2000
试试:

这个输入框打开的是本站唯一的模型 FLUX 3 Klein。不需要安装,也不会下载任何文件。

动手之前先准备什么

模板只认一套固定的版本、文件和 checkpoint 组合。下面四项里有一项不对,工作流要么加载不了,要么在采样时报错。

ComfyUI 0.41.0 或更高

FLUX 3 Klein 模板需要 ComfyUI 0.41.0 及以上版本,随 0.41.1 回移发布。如果模板列表里找不到它,先更新 ComfyUI。

能访问 gated 权重仓库

权重放在 Hugging Face 的 black-forest-labs/flux-3-image-klein-comfy。登录后打开仓库并接受许可协议,否则文件一直处于锁定状态。

五个文件,三个目录

两个扩散模型 checkpoint、一个文本编码器、一个提示词扩写器和 FLUX.2 VAE,分别放进 models/diffusion_models/、models/text_encoders/ 和 models/vae/。

够用的显存(取决于选哪个 checkpoint)

ComfyUI 文档没有写显存要求。Black Forest Labs 给出的生成器权重是 BF16 11.2 GB、FP8 5.6 GB,并称 INT8 版本在 NVIDIA RTX 显卡上最低 8 GB 显存即可运行;参考代码在 1024x1024 下的峰值更高。完整数字见下方 FAQ。

权重文件和存放目录

模板加载的是 int8(convrot)单文件 checkpoint;同一仓库里还有 bf16 和 nvfp4 版本。把下载好的文件放进下面这些目录。

所在目录用途
flux3_image_klein_base_int8_convrot.safetensorsmodels/diffusion_models/完整版 FLUX 3 Klein checkpoint;文生图和图片编辑模板都用它
flux3_image_klein_sd_int8_convrot.safetensorsmodels/diffusion_models/蒸馏版 checkpoint,用于 4 到 16 步的快速生成
qwen3vl_4b_int8_convrot.safetensorsmodels/text_encoders/两个 checkpoint 共用的文本编码器;用 CLIPLoader 加载,type 选 flux3
qwen3.5_9b_flux3_prompt_upsampler_w4a8.safetensorsmodels/text_encoders/文生图模板使用的提示词扩写器
flux2-vae.safetensorsmodels/vae/FLUX 3 Klein 用的 VAE,也就是 FLUX.2 VAE

路径相对于你的 ComfyUI 目录。仓库是 gated 的:先到 huggingface.co/black-forest-labs/flux-3-image-klein-comfy 接受许可,文件才会解锁。来源:docs.comfy.org/tutorials/flux/flux-3-klein,2026 年 10 月 17 日查阅。

四个工作流分别怎么跑

模板库里一共有四个 FLUX 3 Klein 工作流:文生图和图片编辑,各有一个完整版和一个蒸馏版。

  1. 文生图(完整版 checkpoint)

    打开「FLUX 3 Image Klein: Text to Image」,在子图里填提示词,设置宽高或用 ResolutionSelector 选画幅,steps 保持 50、cfg 保持 3.5。Qwen3.5 9B 扩写器默认开启;想用自己写的词采样,就把 enable_prompt_upsampler 关掉。

  2. 文生图(蒸馏版)

    这个工作流加载 flux3_image_klein_sd_int8_convrot.safetensors,16 步运行,cfg 固定为 1,所以调高 cfg 没有用。想快速出图可以一路降到 4 步。

  3. 图片编辑(完整版 checkpoint)

    在 LoadImage 节点载入原图,接到 Set Reference Multi Latent。指令要写成对最终成图的完整描述,官方示例 prompt 是「In <ref_image_0>, change the dress color <obj_1> to red」。画布来自 Empty Flux 2 Latent(模板里是 1024x1024),这里 guidance 是 1。

  4. 图片编辑(蒸馏版)

    一张参考图、一句指令、16 步、无 guidance。steps 保持在 4 到 16 之间,cfg 留在 1,然后在 ImageCompare 里对比原图和结果。

影响出图的提示词与参考图技巧

下面五条来自 ComfyUI 官方文档,它们对结果的影响比任何采样参数都大。

  • 描述结果,而不是描述改动

    编辑模板要的是对最终成图的完整描述,改动包含在其中:官方示例写的是新颜色和它作用的对象,而不是一句「改成这样」。

  • ComfyUI 的参考图从 0 开始编号

    把附加图片按顺序接到 Set Reference Multi Latent,在提示词里用 <ref_image_0>、<ref_image_1> 指代。注意差异:ComfyUI 模板从 <ref_image_0> 开始,而本站生成器从 <ref_image_1> 开始,并且最多 3 张。

  • 参考图尺寸就是成本旋钮

    模板会把每张参考图缩到约 1 百万像素,输出 latent 也按这个尺寸走。参考图保持原始尺寸能把更多细节带进编辑,但代价更高。

  • 步数跟着 checkpoint 走

    完整版 checkpoint 文生图 50 步、guidance 3.5,编辑 1;蒸馏版 16 步、guidance 固定 1。不要把完整版的设置套到蒸馏版上。

  • 模板自带 Create Bounding Boxes 节点

    它用来规划区域编辑:在源图上画框,再用 Preview Any 把框列出来。

许可证写了什么

只列发布方自己公布的要点,按原文口径引用。这不是对许可证的解读:如果打算出售生成结果,请先读原文。

许可原文要点
FLUX 3 Klein 权重FLUX Kommunity License:非商业用途,另有商业输出例外——年营收低于 500 万美元的 Qualifying User 可商用输出,具体以许可条款为准
文本编码器(Qwen3-VL-4B-Instruct)Apache-2.0
仓库访问Hugging Face 上是 gated 仓库;先接受许可,文件才解锁
许可全文权重仓库里的 LICENSE.md(链接见下方)

来源:bfl.ai/blog/flux-3-image-klein、huggingface.co/black-forest-labs/flux-3-image-klein-base,以及 gated 权重仓库里的 LICENSE.md,均于 2026 年 10 月 17 日查阅。只转述公开条款,不构成法律意见。

权重去哪里下载

本站用自己的服务器跑 FLUX 3 Klein,不托管也不出售权重,这里没有任何可下载的文件。权重在 Hugging Face,上面的步骤来自 ComfyUI 官方文档。

在本地运行 FLUX 3 Klein

跑 FLUX 3 Klein 需要哪个 ComfyUI 版本?

0.41.0 或更高。模板随 0.41.1 回移发布,所以模板列表里没有「FLUX 3 Image Klein」时,先更新 ComfyUI 再看一次。

可以从本站下载 FLUX 3 Klein 权重吗?

不能。本站是在浏览器里替你运行模型,不托管权重文件。请先接受许可协议,再去 Hugging Face 的 gated 仓库 black-forest-labs/flux-3-image-klein-comfy 下载。

FLUX 3 Klein 需要多少显存?

ComfyUI 文档没有写。Black Forest Labs 公布的生成器权重是 BF16 11.2 GB、FP8 5.6 GB,并称 INT8 版本在 RTX 显卡上最低 8 GB 显存可跑。其参考代码在 1024x1024 下峰值为 BF16 31 GB、FP8 29 GB、NVFP4 26 GB,80 GB 显卡上开扩写器再加约 28 GB。以上都是厂商自己的数字。

为什么工作流会先改写我的提示词?

因为文生图模板默认开启 Qwen3.5 9B 提示词扩写器,它会把一句简短请求扩写成完整的场景描述。想用自己的原话采样,把 enable_prompt_upsampler 关掉即可。

ComfyUI 模板和这里生成器的参考图编号一样吗?

不一样。ComfyUI 从 <ref_image_0> 开始;本站生成器从 <ref_image_1> 开始。两边互搬提示词时记得改编号。

先试提示词,再决定装不装

在上面的输入框里写一条提示词跑一次,满意了再把措辞搬进 ComfyUI。

查看套餐