Qwen-Image-2.1-GGUF文生图工作流教程:从导入JSON到出图的5步实操
Qwen-Image-2.1-GGUF文生图工作流教程:从导入JSON到出图的5步实操
Qwen-Image-2.1-GGUF 提供 Qwen-Image-2.1 文生图模型的 GGUF 量化版权重,专为 ComfyUI 低显存出图优化。本教程带你用仓库自带的 Qwen_Image_2.1_GGUF_Text2Image.json 工作流,按 5 步完成从导入 JSON 到生成图片的完整流程。
一、准备工作:确认环境与显存档位
跑通本教程前,你需要准备好以下三样东西:
| 组件 | 说明 | 存放位置 |
|---|---|---|
| GGUF 扩散模型 | 本仓库的量化权重(本教程以 qwen_image_2.1_Q4_K_M.gguf 为例) |
ComfyUI/models/diffusion_models/ |
| 文本编码器 | Qwen-Image-2.1 配套的 text encoder | ComfyUI/models/clip/ |
| VAE | Qwen-Image-2.1 配套的 VAE 文件 | ComfyUI/models/vae/ |
仓库内置 6 个量化档位,按你的显存对号入座:
| 文件 | 大小 | 推荐显存 | 特点 |
|---|---|---|---|
| qwen_image_2.1_Q8_0.gguf | 7.59 GB | 12 GB+ | 近乎无损 |
| qwen_image_2.1_Q6_K.gguf | 5.88 GB | 10–12 GB | 质量甜点 |
| qwen_image_2.1_Q5_K_M.gguf | 5.01 GB | 8–10 GB | 性能均衡 |
| qwen_image_2.1_Q4_K_M.gguf | 4.19 GB | 6–8 GB | 消费级主力 |
| qwen_image_2.1_Q4_K_S.gguf | 4.06 GB | 6–8 GB | 更紧凑 |
| qwen_image_2.1_Q3_K_M.gguf | 3.19 GB | 4–6 GB | 极限低显存 |
💡 6 GB 显存的用户直接选 Q4_K_M,即可在 1024×1024 分辨率下流畅出图。
二、第 1 步:安装 ComfyUI-GGUF 自定义节点
GGUF 权重无法被 ComfyUI 原生加载,需要借助 ComfyUI-GGUF 自定义节点:
- 打开 ComfyUI Manager(管理器);
- 在 "Install Custom Nodes" 中搜索
ComfyUI-GGUF并安装; - 重启 ComfyUI,确认节点列表中出现
UnetLoaderGGUF。
三、第 2 步:导入文生图 JSON 工作流
- 下载仓库内的 Qwen_Image_2.1_GGUF_Text2Image.json(图生图/编辑需求可用 Qwen_Image_2.1_GGUF_Image2Image_Edit.json);
- 直接将 JSON 文件拖入 ComfyUI 画布,工作流自动加载;
- 画布上会出现四个分组:Models(模型)、Image Size(尺寸)、Conditioning(条件编码)、Sampling(采样)。
四、第 3 步:在 GGUF 加载节点选择模型
展开工作流主体后,核对三个模型加载节点:
- UnetLoaderGGUF:在下拉框中选中你下载的
qwen_image_2.1_Q4_K_M.gguf(这是最关键的一步,选不到文件说明权重没放进diffusion_models目录); - CLIPLoader:确认指向文本编码器文件,类型为
qwen_image; - VAELoader:确认指向 VAE 文件。
三个加载器都显示正确文件名后,即可进入下一步。
五、第 4 步:填写提示词与生成参数
工作流顶层面板已把常用参数聚合在一处,默认值即为推荐配置:
| 参数 | 默认值 | 说明 |
|---|---|---|
| prompt | 示例咖啡车提示词 | 支持英文提示词,写得越具体效果越好 |
| cfg | 1 | 该模型无需高 CFG,保持 1 即可 |
| steps | 25 | 采样步数,追求更细节可加到 30 |
| sampler / scheduler | euler / simple | 默认组合,稳定省心 |
| 尺寸 | 1024 × 1024 | 由 ResolutionSelector 节点提供,可切换比例 |
六、第 5 步:排队生成并查看出图
- 点击右上角 Queue Prompt(或 "Queue Size: 1");
- 生成完成后,SaveImageAdvanced 节点会实时显示预览,图片自动保存为
Qwen_image_2.1_XXXXX.png到ComfyUI/output/目录; - 换随机种子(seed)即可复现或探索不同构图。
七、常见问题速查
Q:加载节点下拉框里没有我的 GGUF 文件?
A:检查文件是否放在 ComfyUI/models/diffusion_models/(或 unet 目录),放对后刷新页面即可。
Q:出图显存不足、直接报错? A:换更低量化档位,如从 Q4_K_M 降到 Q3_K_M;同时把分辨率调回 1024×1024 以内。
Q:文字渲染不准确? A:该模型对提示词中的文字支持较好,建议把要渲染的文案用引号明确写出,并增加 steps 到 30。
更多背景资料与量化说明可查阅仓库文档 README.md。至此,一套完整的 Qwen-Image-2.1-GGUF 文生图工作流就跑通了——6 GB 显存也能享受高质量出图。🎨
登录后查看全文

