Z-image-turbo模型ComfyUI部署：从下载报错到高效出图

薛定谔的头发

2617人浏览 · 2026-01-10 23:38:39

薛定谔的头发 · 2026-01-10 23:38:39 发布

Z-image-turbo模型ComfyUI部署：从下载报错到高效出图

❝
新模型又翻车？别急着关掉报错信息，依次解决让你把Z-image-turbo成功跑起来。

1. 模型介绍与下载

2025年12月，Z-Image（造相）发布了Z-Image-Turbo模型。Z-Image是一个强大的、高效的图像生成模型，具有6B参数，而Z-Image-Turbo是其精简版，生图速度快且质量直逼闭源旗舰模型，可以在16G显存的消费设备上轻松运行，支持双语文本渲染（英文和中文）。

关于模型下载，有非常多的途径获取：

（推荐）在B站或者其他途径网盘下载，优势是无需翻墙，分享者已打包其他配套模型。
通过魔搭社区、Hugging Face、Civitai等网站下载。

2. 模型本地部署

2.1 ComfyUI更新

首先，确保你的ComfyUI已经更新到了最新版本（注意备份现有版本）。如果你用的是桌面版、云端或分享者的整合包，一般都带有更新选项，运行直接更新即可。

如果你是通过源码部署的ComfyUI，可以在GitHub上： https://github.com/comfyanonymous/ComfyUI

Git或者下载最新的ComfyUI文件夹到本地，再把旧版本ComfyUI文件夹中的文件迁移到新版本中：

extra_model_paths.yaml文件：存放模型等文件的路径信息；

models文件夹：存放的各类模型；

custom_nodes文件夹：存放的所有自定义插件节点；

input, output, user文件夹：输入、输出以及用户（你的工作流存放位置）文件夹都是可选项。

2.2 Manager管理器及插件更新

插件的安装更新方式几乎一样。进入GitHub官网搜索comfyui找到manager：

打开ComfyUI文件夹的custom_nodes文件夹，再使用git clone下载到文件夹，或者直接下载后Manager文件并解压到文件夹。

运行以前的工作流，尝试是否可以顺利运行。注意部分插件可能不适配新版的ComfyUI，需要进行更新或者替换。

2.3 模型部署与运行

把下载好的z_image_turbo.safetensors，qwen_3_4b.safetensors，ae.safetensors模型分别放入models文件夹下的diffusion_models，clip，vae文件夹中，创建一个最简单的文生图工作流，或者直接使用分享者的文生图工作流。

注意KSampler设置，步数不要过高（8-12步左右），20步以上反而可能导致过饱和和画质下降；CFG设置为1.0；采样器选euler即可。

3. 常见报错

3.1 ComfyUI未更新

这个报错的核心是模型权重与模型结构 “尺寸不合”，解决关键是让权重文件与模型版本/架构一一对应，优先下载匹配的专用权重文件，ComfyUI更新到最新版即可快速解决此问题。

3.2 Manager未更新

ComfyUI Revision: UNKNOWN (The currently installed ComfyUI is not a Git repository)，当更新完ComfyUI后，还是报这个错误，是因为ComfyUI-Manager管理器未更新，按上述方法更新完Manager后即可解决。

3.3 Xformer版本问题

当你的工作流需要用到Xformers时，容易出现这个报错。编译时的架构适配与运行时的节点调用不匹配（编译时未真正适配12.0算力，节点仍调用旧版算子逻辑），使用python -m xformers.info显示核心算子是available的，但运行时仍提示算力不兼容。

核心原因是Xformers编译时的TORCH_CUDA_ARCH_LIST未包含 12.0 算力（输出显示仅包含8.0/9.0），导致算子仅在检测层面显示可用，实际运行时无法适配12.0 GPU，节点仍会调用不兼容的旧算子逻辑。解决方案可以参考GitHub上这个Issue： https://github.com/facebookresearch/xformers/issues/1356

但根据相关评论，这个方式只是解决了报错，加速效果并不明显。