> ## 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는 1초 미만의 추론 지연 시간을 제공하는, 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 (造相)\*\*는 Alibaba의 Tongyi Lab이 개발한 **6B** 파라미터의 강력하고 매우 효율적인 이미지 생성 모델입니다. **Scalable Single-Stream DiT**(S3-DiT) 아키텍처를 사용하여 텍스트, 시각적 의미 토큰, 이미지 VAE 토큰을 시퀀스 수준에서 연결해 통합된 입력 스트림으로 사용함으로써 파라미터 효율성을 극대화합니다.

**모델 변형**:

* 🚀 **Z-Image-Turbo**: 단 **8 NFE**(함수 평가 횟수)만으로 주요 경쟁 모델과 동등하거나 뛰어난 성능을 제공하는 증류 버전입니다. 엔터프라이즈급 H800 GPU에서 **1초 미만의 추론 지연 시간**을 제공하며 **16GB VRAM 소비자용 디바이스**에도 적합합니다.
* 🧱 **Z-Image-Base**: 커뮤니티 주도의 파인튜닝 및 커스텀 개발을 위한 비증류 파운데이션 모델입니다.
* ✍️ **Z-Image-Edit**: 인상적인 지시 준수 능력을 갖춘 이미지 편집 작업용 파인튜닝 변형입니다.

**모델 특징**:

* **사실적인 품질**: 뛰어난 미적 품질을 유지하면서 강력한 사실적 이미지 생성 제공
* **정확한 이중 언어 텍스트 렌더링**: 복잡한 중국어와 영어 텍스트를 정확하게 렌더링하는 데 탁월
* **프롬프트 향상 및 추론**: Prompt Enhancer가 모델에 추론 능력을 부여
* **1초 미만 추론**: 지원되는 하드웨어에서 빠른 생성 속도 달성

**관련 링크**:

* [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)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로는 [워크플로 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.

      워크플로를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="클라우드 사용자">
      * [클라우드](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
```