先解决「搜不到」
不少人第一次找这个模型会扑空,因为它在三个地方叫三个名字:
- 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 基线有数倍加速,但测量条件彼此不同、且都未经独立复测。这里刻意不写具体秒数——照抄一个脱离条件的数字,比不给数字更容易误导。真要估算,请按自己的显卡、步数和量化档实测一次。
五个高频报错,按顺序排查
- 节点变红 / 提示缺节点 —— 用了没装的自定义节点,用 ComfyUI-Manager 补,装完重启。
- 模型下拉显示 null —— 九成是放错目录。按上表核对,按 R 刷新。
- CUDA out of memory —— 先降分辨率、batch 改 1、关掉浏览器和游戏,再考虑换量化档。
- 出图全黑或偏色 —— 检查 VAE 是否与模型匹配、KSampler 是否接到正确的 VAE Decode;必要时对 VAE 提精度。
- 点了运行没反应 —— 只有连到输出节点的子图才会执行,检查 Save Image 有没有断线、节点是不是被静音了。
排查有个通用原则:先跑通一条最小链路(加载模型 → 提示词 → 空 Latent → 采样 → VAE 解码 → 保存),确认基础环境没问题,再往上叠加多图参考和坐标控制。一上来就 4K 加十张参考图,出问题时根本分不清是哪一环。
最后一句关于许可证
权重用的是 FLUX Kommunity License,不是通用开源协议。模型卡的表述是允许非商业使用,并对符合条件的主体给出商业输出例外;有媒体转述为「年营收低于 500 万美元可免费商用」,但这是转述。
要拿产出做商业用途,请自己读一遍许可证原文。这一步省掉,前面所有部署工作都白搭。
说明与免责
本文为公开资料整理与实践经验总结,仅供技术学习参考,不构成采购、投资或法律建议。
- 文中涉及的模型版本、参数、显存门槛与许可证条款会随官方更新而变化,请以模型官方仓库、官方文档及许可证原文为准。本文不提供任何模型文件、整合包或第三方资源的下载与分发。
- 文中提及的第三方名称、商标、模型与平台归各自权利人所有,引用仅为说明技术事实,不代表授权、背书或关联。
- 涉及监管规则、通报与司法案例的内容为对已公开信息的整理,不构成法律意见;具体适用请以主管部门、司法机关发布的原文为准。
- 按本文操作产生的设备配置、数据、产出物及其使用后果,由操作者自行判断与承担。如发现内容有误或已过时,欢迎指正,本文会及时修订。
评论 0