Z-image-turbo模型ComfyUI部署:从下载报错到高效出图
2025年12月,Z-Image发布了Z-Image-Turbo模型。这是一款具有6B参数的精简版图像生成模型,生图速度快且质量直逼闭源旗舰模型。该模型支持双语文本渲染(英文和中文),并可在16G显存的消费级设备上轻松运行。以下是从环境准备、模型下载到常见报错解决的完整部署流程。
01环境准备与更新
- 更新ComfyUI
确保ComfyUI更新到最新版本,并备份现有版本。桌面版、云端或整合包通常带有更新选项,直接运行即可。源码部署用户可通过GitHub下载最新版本或使用Git更新。 - 迁移旧版文件
将旧版本文件夹中的extra_model_paths.yaml(路径信息)、models(模型)、custom_nodes(插件)、input/output/user(输入输出及工作流)迁移至新版文件夹中。 - 更新ComfyUI-Manager
进入custom_nodes文件夹,使用git clone下载Manager或直接下载解压。若出现“ComfyUI Revision: UNKNOWN”报错,通常是因为Manager未更新,按上述方法更新即可解决。
02模型下载与放置
- 下载模型文件
获取z_image_turbo.safetensors(主模型)、qwen_3_4b.safetensors(文本编码器)、ae.safetensors(自编码器)。 - 放置路径
将模型分别放入ComfyUI根目录下的models文件夹中对应位置:z_image_turbo.safetensors放入diffusion_models;qwen_3_4b.safetensors放入clip;ae.safetensors放入vae。
03基础工作流搭建与参数设置
创建一个最简单的文生图工作流,或直接使用分享者的工作流。成功运行的关键在于正确设置KSampler参数,以避免过饱和或画质下降。以下是关键参数的配置建议。
| 参数名称 | 推荐设置 | 设置说明 |
|---|---|---|
| 步数 (Steps) | 8-12步 | 20步以上可能导致过饱和和画质下降 |
| CFG | 1.0 | 引导系数设置 |
| 采样器 (Sampler) | euler | 推荐使用的采样器类型 |
Z-Image-Turbo KSampler关键参数设置
04常见报错与解决方案
- 模型权重与结构不匹配
现象:模型权重与模型结构“尺寸不合”。解决:确保下载匹配的专用权重文件,并将ComfyUI更新到最新版。 - Xformers算力不兼容
现象:运行时提示算力不兼容,尽管python -m xformers.info显示可用。原因:编译时的TORCH_CUDA_ARCH_LIST未包含12.0算力。解决:参考GitHub Issue修改,但需注意加速效果可能不明显。 - 节点缺失
现象:打开工作流时检测模型或节点缺失。解决:使用“Install Missing Custom Nodes”功能安装,或手动将源文件复制进custom_nodes文件夹。 - VAE加载报错
现象:工作流报错提示找不到VAE,但本地文件存在(如wan_2.1_vae.safetensors)。原因:作者模型命名不同(如后缀034a...)。解决:在加载VAE节点中选择本地实际对应的模型文件。
成功部署Z-Image-Turbo后,可在Civitai等社区下载对应的LoRA、Controlnet等工具模型进行扩展。注意选择专为Z-Image-Turbo(ZIT)设计的模型以确保兼容性。
当前文章无评论,是时候发表评论了