非官方指南,与 Meta 无关联。

最后更新:

在 ComfyUI 和自己的显卡上运行 Qwen Image 2.1 Turbo

10 月 9 日发布后几小时内,ComfyUI 就重新打包了 Turbo 权重,社区 GGUF 量化版也随后跟上。本页列出需要的具体文件、真正要紧的采样设置,以及如何按显卡选择量化版本。

一句话结论: 使用官方 Qwen-Image 2.1 工作流,换成 qwen_image_2.1_turbo_bf16.safetensors,设置 8 步、CFG 1。显存不够?用 INT8 文件或 GGUF 量化版:Q8_0(7.59 GB)最接近原版,AD-Q4_K(4.20 GB)是 4-bit 首选。务必保留 Turbo 的 sigma 调度,否则出图效果会变。

需要下载的文件

文件(Comfy-Org/Qwen-Image-2.1)说明
diffusion_models/qwen_image_2.1_turbo_bf16.safetensors完整 8 步 Turbo 检查点,BF16
diffusion_models/qwen_image_2.1_turbo_int8_convrot.safetensorsINT8 量化 Turbo,占用显存更少
loras/qwen_image_2.1_turbo_lora_avg_rank_178_bf16.safetensorsLoRA 形式的 Turbo,叠加在 Qwen-Image 2.1 基础模型上
文本编码器和 VAE与 Qwen-Image 2.1 共用;使用同一仓库中的文件

来源: Comfy-Org 重新打包的权重

来源: ComfyUI Wiki 发布说明

ComfyUI 部署步骤

  1. 将 ComfyUI 更新到支持 Qwen-Image 2.1 的版本。
  2. 把 Turbo 扩散模型下载到 ComfyUI/models/diffusion_models/,再把 Qwen-Image 2.1 的文本编码器和 VAE 放进各自的文件夹。
  3. 打开官方 Qwen-Image 2.1 文生图工作流。
  4. 把模型加载节点指向 Turbo 文件,或保留基础模型并加上 Turbo LoRA。
  5. 采样器设为 8 步、CFG 1。先用 1024 × 1024 确认能跑通,再切换到 2K 预设。

Kijai 指出 Turbo 的 sigma 调度接近 ComfyUI 中不加 shift 的 linear_quadratic 调度器。Qwen 表示除检查点内置调度外的其他调度未经测试。

来源: ComfyUI Wiki 发布说明

来源: Comfy-Org 重新打包的权重

关键参数设置

参数Turbo 取值
步数(Steps)8
CFG1(每步只需一次前向计算)
采样器Euler,流匹配(flow matching)
Sigmas1.0, 0.978453, 0.95418, 0.926626, 0.89508, 0.845148, 0.704534, 0.414568,最后为 0
分辨率原生 2048 × 2048;快速测试用 1024 × 1024

来源: Hugging Face 模型卡

来源: ComfyUI Wiki 发布说明

来源: AtomicChat GGUF 模型卡

GGUF 量化版本怎么选

AtomicChat 发布了适用于 stable-diffusion.cpp 的 GGUF 文件,并测量了各版本与 BF16 原版的偏差(1024 × 1024 下的 LPIPS,越低越接近)。

文件大小相对 BF16 的 LPIPS
BF1614.23 GB0
Q8_07.59 GB0.037
AD-Q6_K6.71 GB0.044
AD-Q5_K5.40 GB0.076
AD-Q4_K4.20 GB0.147
AD-Q3_K3.60 GB0.206
AD-Q2_K2.55 GB0.359

来源: AtomicChat GGUF 模型卡

需要多少显存

Qwen 没有公布 Turbo 的最低显存要求。以下是第三方针对基础版的估算,两者模型大小相同。

你的硬件推荐方案(Unsloth 估算)
6 GB 显存FP8 加卸载,速度慢不到 2 倍
12–16 GB 显存GGUF Q4_K_M,1024 × 1024
24 GB 显存INT8 / FP8 权重
仅 CPU,12–16 GB 内存GGUF Q4_K_M 配 4-bit 文本编码器(较慢)
Apple Silicon,16 GB 以上GGUF 配原生后端

Turbo 每一步占用的内存与基础版相同;它省的是时间,因为只跑 8 步而不是 40 步。

来源: Unsloth Qwen-Image-2.1 文档

用 Diffusers 降低显存占用

在 Python 中,CPU 卸载只把当前工作的组件留在 GPU 上。速度会变慢,但小显存显卡也能跑 BF16 检查点。

pip install "torch>=2.4.0"
pip install git+https://github.com/huggingface/diffusers.git
pip install "transformers>=5.17.0" accelerate pillow

# Less VRAM: keep only the active part of the model on the GPU (slower)
pipe = QwenImage21Pipeline.from_pretrained("Qwen/Qwen-Image-2.1-Turbo", dtype=torch.bfloat16)
pipe.enable_model_cpu_offload()

主教程中的完整 Python 示例

来源: Qwen-Image-2.1 GitHub 仓库

来源: Hugging Face 模型卡

常见问题

Qwen Image 2.1 Turbo 在 ComfyUI 中的最佳参数是什么?

8 步、CFG 1、Euler 采样,配合 Turbo 的 sigma 调度(接近不加 shift 的 linear_quadratic)。

用 Turbo 检查点还是 Turbo LoRA?

检查点更简单。LoRA 可以让你硬盘上只保留一个基础模型,在 40 步和 8 步生成之间切换。

应该下载哪个 GGUF?

放得下就用 Q8_0(7.59 GB),否则用 AD-Q4_K(4.20 GB)。除非别的都放不下,否则避免 Q3 和 Q2。

8 GB 显存能跑吗?

Qwen 没有公布最低要求。Unsloth 估计 FP8 加卸载在 6 GB 上可以运行(慢不到 2 倍),4-bit GGUF 在 1024 × 1024 下需要 12–16 GB。从小尺寸开始,batch size 设为 1。

为什么我的 Turbo 出图效果不对?

通常是调度问题:改了步数却没用 Turbo sigmas,或者 CFG 设得高于 1。改回 8 步、CFG 1 和内置调度即可。

独立教程站,与阿里巴巴及通义千问(Qwen)团队无关联。价格、许可证和文件名可能变化,正式使用前请以链接的官方页面为准。