Boogu-Image Turbo ComfyUI 出图设置指南：模型放置、参数调优与低显存排查
【免费下载链接】Boogu-Image项目地址: https://ai.gitcode.com/hf_mirrors/Comfy-Org/Boogu-Image
Boogu-Image Turbo 是一套为 ComfyUI 极速出图场景重新封装的模型文件，包含 turbo 系列扩散模型权重，以及配套的文生图文本编码器、VAE 和 LoRA。把它们放到正确目录后，你就能在 ComfyUI 里搭出一条生成更快、显存占用更低的出图链路。下面从文件下载、目录放置讲到参数设置和低显存设备的排错方法。
一、这套模型是什么，适合谁用
Boogu-Image 是为 ComfyUI 重新打包的模型文件集合，原始模型来自 HuggingFace 上的 Boogu 项目。按文件名划分，扩散模型大致分三组：
base系列：标准生成edit系列：通常用于图像编辑场景turbo系列：快速生成，仓库中另提供了对应的 LoRA
仓库里还有 turbo 的 hotfix 版本文件，具体用途以仓库 README 中的说明为准。如果你正在使用 ComfyUI，希望缩短等待时间或降低显存压力，可以从这套文件入手。
二、安装前检查清单
动手前先确认这几项：
- ComfyUI 已安装完毕，界面可以正常打开
models目录下已存在（或准备创建）diffusion_models、loras、text_encoders、vae四个子目录- 磁盘空间充足：不同精度文件体积不同，建议先估算再下载
- 显存量级有数：nvfp4 版本适合较低显存设备，最低约 4GB 显存即可尝试，8GB 以上运行更从容
三、下载模型并放入正确目录
第一步，克隆仓库：
git clone https://gitcode.com/hf_mirrors/Comfy-Org/Boogu-Image第二步，把文件放到 ComfyUI 对应位置：
| 仓库子目录 | ComfyUI 目标目录 | 内容 |
|---|---|---|
diffusion_models/ | models/diffusion_models/ | 扩散模型权重 |
loras/ | models/loras/ | LoRA 权重 |
text_encoders/ | models/text_encoders/ | 文本编码器 |
vae/ | models/vae/ | VAE |
不需要全部搬过去。按你打算使用的精度，只移动对应文件即可。
四、关键文件用途速查
| 文件 | 作用 |
|---|---|
boogu_image_turbo_bf16.safetensors及各精度版本 | turbo 快速生成用的扩散模型，按显存选其一 |
boogu_image_turbo_lora_rank_128_bf16.safetensors | turbo 模型配套 LoRA，按需加载 |
qwen3vl_8b_fp8_scaled.safetensors | 文本编码器，与扩散模型配合使用 |
flux1_vae_bf16.safetensors | VAE 解码器 |
五、按显存选择精度
以 turbo 系列为例，常见精度对应的定位如下：
| 硬件情况 | 建议精度 | 说明 |
|---|---|---|
| 高显存显卡 | bf16 | 质量最佳，显存占用最高 |
| 中等配置 | fp8_scaled | 速度与质量的折中 |
| 低显存设备 | nvfp4 | 显存占用最低 |
仓库中还提供了int8_convrot量化版本，若以上三档不适合你的设备，可以再尝试这一档。
六、工作流参数设置与推荐值
搭建工作流时，按以下部分衔接：
- 加载 turbo 系列模型
- 文本编码器选择
qwen3vl_8b_fp8_scaled - VAE 使用
flux1_vae_bf16 - 需要风格微调时，再叠加
boogu_image_turbo_lora
采样参数参考值：
| 参数 | 建议 |
|---|---|
| 步数 | 15-20 |
| CFG Scale | 5-8 |
| 采样器 | DPM++ 2M Karras 或 Euler a |
| 分辨率 | 512x512 至 1024x1024 |
批量测试时，批量大小设在 4-8 比较合适；批量越大，对显存的压力也越大。
七、常见报错处理
| 现象 | 可能原因 | 处理方法 |
|---|---|---|
| 生成时显存不足 | 显存不够 | 换用 fp8 或 nvfp4 精度，减小批量，启动时加--lowvram或--medvram参数 |
| 节点下拉列表里看不到模型 | 文件未放对位置 | 核对文件是否落在models/的对应子目录 |
| 生成速度达不到预期 | 使用了非 turbo 或高精度文件 | 换成 turbo 系列并搭配量化精度 |
| 需要更新模型 | 仓库发布了新版本 | 直接替换对应目录中的文件，工作流一般无需改动 |
八、完成前核对清单
models/下四个子目录的文件均已就位- 重启 ComfyUI 后，节点下拉列表中出现所选模型
- 先用 512x512、15 步跑通一次完整流程
- 显存吃紧时，已降级到 fp8 或 nvfp4 再复跑
- 验证通过的工作流已另存为模板，方便后续复用
【免费下载链接】Boogu-Image项目地址: https://ai.gitcode.com/hf_mirrors/Comfy-Org/Boogu-Image
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
