先解决「搜不到」

不少人第一次找这个模型会扑空,因为它在三个地方叫三个名字:

  • Black Forest Labs 官方叫 FLUX 3 Image Klein
  • ComfyUI 文档里写 FLUX.3 [klein]
  • 实际文件名和仓库名是 flux3-image-klein

三个指的是同一个模型。搜不到的时候换另外两个写法试一次,通常就出来了。

还有个流传挺广的说法是「开放权重数周内公开」。以官方仓库为准:Klein 的权重在 2026 年 10 月中旬就已开放,官方镜像仓库 11 月初仍在更新,ComfyUI 从 v0.41.0 起原生支持。把闭源旗舰版和已开源的 Klein 混为一谈,就会一直等一个早就到了的东西。仓库是 gated 的,下载前需要先在平台上接受许可证。

它不是一个文件,是四个

这是本地部署最常卡住的一步。照官方 ComfyUI 仓库的说明,至少要有四类文件,分别放进对应目录:

组件作用放置目录
扩散模型(distilled 或 base)出图主体models/diffusion_models/
文本编码器(Qwen3-VL-4B-Instruct)把提示词转成模型能读的条件models/text_encoders/
FLUX.2 VAE潜空间解码成图models/vae/
Prompt Upsampler把短提示词扩写成完整场景描述models/text_encoders/

第四个别省。官方模型卡里写的是「Always run a prompt upsampler」——Klein 是在完整场景描述上训练的,短提示词直接喂进去,出来的往往是四平八稳的通用图。这也是很多人换模型后觉得「没变强」的真实原因,不在模型,在输入。

「5.6B」这个数字只指图像 transformer 本身,文本编码器是另外算的。别按 5.6B 去估算硬盘和显存。

显存:几个官方数字,别只看那个小的

BFL 给出的说法是 int8 构建最低 8GB 显存可跑,点名了 RTX 3070;官方模板对 BF16 权重的建议门槛是显存 24GB 以上;另有第三方托管平台给出的示例配置是 L40S(48GB)。

这几个数字不矛盾,但语境完全不同:8GB 是「int8 量化档能启动、能出图」,24GB 是「想上 BF16 全精度」,48GB 是「托管平台的舒适示例」。看到「8G 也能跑」就按 8G 配环境、还想跑 4K 和十张参考图,大概率撞墙。

量化档大致这么选:

  • BF16:质量基准,占显存最多,适合 24GB 以上
  • int8:显存与质量的主要折中档,8–16GB 的现实选择
  • NVFP4:更省,适合先跑通流程;画质损失要自己验,且需要对应架构的显卡

文件名后缀会标明档位和是否 base。带 -base- 的是未蒸馏版:50 步、CFG 3.5,留给微调和 LoRA 训练;不带的是蒸馏版,16 步、无 guidance,日常出图用这个。拿 base 当日常模型用,会又慢又不出彩。

各档文件体积差别很大,网上能查到的几份清单互相也对不上——Prompt Upsampler 一项就有多个数字,其实是不同量化档、不同仓库的合计。别照着别人的合计下载量准备硬盘,以官方仓库当前的实际文件列表为准。

速度同理:厂商公布过多组不同 GPU、不同步数、不同精度下的自测数据,也提过蒸馏版相对 BF16 基线有数倍加速,但测量条件彼此不同、且都未经独立复测。这里刻意不写具体秒数——照抄一个脱离条件的数字,比不给数字更容易误导。真要估算,请按自己的显卡、步数和量化档实测一次。

五个高频报错,按顺序排查

  1. 节点变红 / 提示缺节点 —— 用了没装的自定义节点,用 ComfyUI-Manager 补,装完重启。
  2. 模型下拉显示 null —— 九成是放错目录。按上表核对,按 R 刷新。
  3. CUDA out of memory —— 先降分辨率、batch 改 1、关掉浏览器和游戏,再考虑换量化档。
  4. 出图全黑或偏色 —— 检查 VAE 是否与模型匹配、KSampler 是否接到正确的 VAE Decode;必要时对 VAE 提精度。
  5. 点了运行没反应 —— 只有连到输出节点的子图才会执行,检查 Save Image 有没有断线、节点是不是被静音了。

排查有个通用原则:先跑通一条最小链路(加载模型 → 提示词 → 空 Latent → 采样 → VAE 解码 → 保存),确认基础环境没问题,再往上叠加多图参考和坐标控制。一上来就 4K 加十张参考图,出问题时根本分不清是哪一环。

最后一句关于许可证

权重用的是 FLUX Kommunity License,不是通用开源协议。模型卡的表述是允许非商业使用,并对符合条件的主体给出商业输出例外;有媒体转述为「年营收低于 500 万美元可免费商用」,但这是转述。

要拿产出做商业用途,请自己读一遍许可证原文。这一步省掉,前面所有部署工作都白搭。

说明与免责

本文为公开资料整理与实践经验总结,仅供技术学习参考,不构成采购、投资或法律建议。

  • 文中涉及的模型版本、参数、显存门槛与许可证条款会随官方更新而变化,请以模型官方仓库、官方文档及许可证原文为准。本文不提供任何模型文件、整合包或第三方资源的下载与分发。
  • 文中提及的第三方名称、商标、模型与平台归各自权利人所有,引用仅为说明技术事实,不代表授权、背书或关联。
  • 涉及监管规则、通报与司法案例的内容为对已公开信息的整理,不构成法律意见;具体适用请以主管部门、司法机关发布的原文为准。
  • 按本文操作产生的设备配置、数据、产出物及其使用后果,由操作者自行判断与承担。如发现内容有误或已过时,欢迎指正,本文会及时修订。