本地部署指南
如何在 ComfyUI 里运行 FLUX 3 Klein
FLUX 3 Klein 既开放权重,也有 ComfyUI 模板,可以放在自己的显卡上跑,不需要 API Key,也没有按张计的积分。下面写清装什么、文件放哪里、四个自带工作流有什么区别,以及许可证允许什么。
本地 ComfyUI,还是在浏览器里跑
本地 ComfyUI 能把整个流程留在自己机器上:提示词、参考图和输出文件都不离开你的硬盘,也不按张收费。但它的配置成本最高,因为模板对 ComfyUI 版本、五个文件和每个任务对应的 checkpoint 都有要求。
如果只是想看看模型对手上的提示词有什么反应,完全可以跳过安装。本站用服务器跑 FLUX 3 Klein,支持最多三张参考图,在这里写一条提示词,一分钟内就能看到结果。
这个输入框打开的是本站唯一的模型 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.safetensors | models/diffusion_models/ | 完整版 FLUX 3 Klein checkpoint;文生图和图片编辑模板都用它 |
| flux3_image_klein_sd_int8_convrot.safetensors | models/diffusion_models/ | 蒸馏版 checkpoint,用于 4 到 16 步的快速生成 |
| qwen3vl_4b_int8_convrot.safetensors | models/text_encoders/ | 两个 checkpoint 共用的文本编码器;用 CLIPLoader 加载,type 选 flux3 |
| qwen3.5_9b_flux3_prompt_upsampler_w4a8.safetensors | models/text_encoders/ | 文生图模板使用的提示词扩写器 |
| flux2-vae.safetensors | models/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 工作流:文生图和图片编辑,各有一个完整版和一个蒸馏版。
文生图(完整版 checkpoint)
打开「FLUX 3 Image Klein: Text to Image」,在子图里填提示词,设置宽高或用 ResolutionSelector 选画幅,steps 保持 50、cfg 保持 3.5。Qwen3.5 9B 扩写器默认开启;想用自己写的词采样,就把 enable_prompt_upsampler 关掉。
文生图(蒸馏版)
这个工作流加载 flux3_image_klein_sd_int8_convrot.safetensors,16 步运行,cfg 固定为 1,所以调高 cfg 没有用。想快速出图可以一路降到 4 步。
图片编辑(完整版 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。
图片编辑(蒸馏版)
一张参考图、一句指令、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> 开始。两边互搬提示词时记得改编号。