> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-0ee014e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Z-Image-Turbo ComfyUI 工作流示例

> Z-Image-Turbo 是一个蒸馏版 6B 参数高效图像生成模型，可实现亚秒级推理延迟。

<iframe width="560" height="315" src="https://www.youtube.com/embed/HvaEsnyOfSw?si=bsOQzcL0vsPcaE83" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

**Z-Image (造相)** 是阿里巴巴通义实验室开发的一款强大且高效的图像生成模型，拥有 **6B** 参数。它采用 **Scalable Single-Stream DiT**（S3-DiT）架构，将文本、视觉语义 token 和图像 VAE token 在序列层面拼接为统一的输入流，从而最大化参数效率。

**模型版本**：

* 🚀 **Z-Image-Turbo**：蒸馏版本，仅需 **8 次 NFE**（函数评估次数）即可达到或超越领先的竞争对手。在企业级 H800 GPU 上可实现**亚秒级推理延迟**，并可适配 **16GB 显存的消费级设备**。
* 🧱 **Z-Image-Base**：未经蒸馏的基础模型，用于社区驱动的微调和自定义开发。
* ✍️ **Z-Image-Edit**：针对图像编辑任务微调的变体，具有出色的指令遵循能力。

**模型亮点**：

* **照片级真实感质量**：在保持出色美学质量的同时，提供强大的照片级真实感图像生成
* **精准的双语文本渲染**：擅长准确渲染复杂的中英文文本
* **提示词增强与推理**：Prompt Enhancer 赋予模型推理能力
* **亚秒级推理**：在支持的硬件上实现快速生成

**相关链接**：

* [GitHub](https://github.com/Tongyi-MAI/Z-Image)
* [Hugging Face](https://huggingface.co/Tongyi-MAI/Z-Image-Turbo)

<Tip>
  <Tabs>
    <Tab title="本地用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新版（每夜版）。
      2. 启动时有些节点导入失败。
    </Tab>

    <Tab title="云端用户">
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新。

      所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。
    </Tab>
  </Tabs>
</Tip>

## Z-Image-Turbo 文生图工作流

<h3 id="image_z_image_turbo">
  Z-Image-Turbo：文生图
</h3>

采用 Single-Stream Diffusion Transformer 的高效图像生成基础模型，支持英文和中文。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_z_image_turbo-1.webp" alt="Z-Image-Turbo text-to-image workflow preview" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 上运行" icon="cloud" href="https://cloud.comfy.org/?template=image_z_image_turbo&utm_source=docs&utm_medium=referral&utm_campaign=z-image-turbo">
    在 Comfy Cloud 上直接运行此工作流
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_z_image_turbo.json">
    下载 Z-Image-Turbo 文生图工作流 JSON 文件
  </Card>
</CardGroup>

**示例输出**

![Z-Image-Turbo example output](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_z_image_turbo.png)

### Z-Image-Turbo 模型下载

<CardGroup cols={2}>
  <Card title="qwen_3_4b.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/z_image_turbo/blob/main/split_files/text_encoders/qwen_3_4b.safetensors">
    Z-Image-Turbo 的文本编码器。
  </Card>

  <Card title="z_image_turbo_bf16.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/z_image_turbo/blob/main/split_files/diffusion_models/z_image_turbo_bf16.safetensors">
    Z-Image-Turbo 的 diffusion 模型。
  </Card>

  <Card title="ae.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/z_image_turbo/blob/main/split_files/vae/ae.safetensors">
    Z-Image-Turbo 的 VAE。
  </Card>
</CardGroup>

**Z-Image-Turbo 模型保存位置**

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 text_encoders/
│   │      └── qwen_3_4b.safetensors
│   ├── 📂 diffusion_models/
│   │      └── z_image_turbo_bf16.safetensors
│   └── 📂 vae/
│          └── ae.safetensors
```

## Z-Image-Turbo Fun Union ControlNet 工作流

<h3 id="image_z_image_turbo_fun_union_controlnet">
  Z-Image-Turbo Fun Union ControlNet
</h3>

为 Z-Image-Turbo 提供 Canny、HED、Depth、Pose 和 MLSD 支持的多控制 ControlNet。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_z_image_turbo_fun_union_controlnet-1.webp" alt="Z-Image-Turbo Fun Union ControlNet workflow preview" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 上运行" icon="cloud" href="https://cloud.comfy.org/?template=image_z_image_turbo_fun_union_controlnet&utm_source=docs&utm_medium=referral&utm_campaign=z-image-turbo">
    在 Comfy Cloud 上直接运行此工作流
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_z_image_turbo_fun_union_controlnet.json">
    下载 Z-Image-Turbo Fun Union ControlNet 工作流 JSON 文件
  </Card>
</CardGroup>

**输入素材**

将此文件上传到对应的 `LoadImage` 节点：

<CardGroup cols={2}>
  <Card title="image_z_image_turbo_fun_union_controlnet_input_image.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/image_z_image_turbo_fun_union_controlnet_input_image.png">
    `LoadImage` 节点 58 · `image_z_image_turbo_fun_union_controlnet_input_image.png`
  </Card>
</CardGroup>

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/image_z_image_turbo_fun_union_controlnet_input_image.png" alt="image_z_image_turbo_fun_union_controlnet_input_image.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

### ControlNet 附加模型

<Card title="Z-Image-Turbo-Fun-Controlnet-Union.safetensors" icon="download" href="https://huggingface.co/alibaba-pai/Z-Image-Turbo-Fun-Controlnet-Union/blob/main/Z-Image-Turbo-Fun-Controlnet-Union.safetensors">
  Z-Image-Turbo 的 ControlNet 模型补丁。
</Card>

**模型保存位置**

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 text_encoders/
│   │      └── qwen_3_4b.safetensors
│   ├── 📂 diffusion_models/
│   │      └── z_image_turbo_bf16.safetensors
│   ├── 📂 vae/
│   │      └── ae.safetensors
│   └── 📂 model_patches/
│          └── Z-Image-Turbo-Fun-Controlnet-Union.safetensors
```
