> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Qwen-Image-2.1 ComfyUI 네이티브 워크플로 예시

> ComfyUI에서 Qwen-Image-2.1을 실행해 보세요. 이미지 생성과 편집을 하나의 모델로 처리하고, 네이티브 2K 출력, 전문적인 타이포그래피, 알파 채널 지원을 제공합니다.

**Qwen-Image-2.1**은 Alibaba Qwen 팀의 Qwen-Image 시리즈에서 최신 오픈 웨이트 릴리스입니다. 단일 모델이 텍스트 기반 이미지 생성과 지시 기반 이미지 편집을 모두 처리하며, 네이티브 2K 출력, 전문적인 타이포그래피, 투명 배경을 위한 알파 채널을 갖추고 있습니다.

**주요 기능**:

* **하나의 모델에서 생성과 편집**: 동일한 가중치가 텍스트 기반 이미지 생성 프롬프트와 편집 지시를 모두 처리하므로, 워크플로에서 체크포인트를 교체할 필요가 없습니다
* **네이티브 2K 출력**: 더 작은 결과를 업스케일링하는 대신 최대 2048x2048로 직접 생성합니다
* **전문적인 타이포그래피**: 인포그래픽, 슬라이드, UI 목업, 포스터, 패키징 디자인에서 촘촘한 작은 텍스트와 복잡한 레이아웃이 유지됩니다
* **알파 채널 지원**: VAE가 4개 채널을 가지므로 투명 배경 이미지를 나중에 잘라내는 대신 직접 생성하고 편집할 수 있습니다
* **다중 이미지 편집**: 참조 이미지는 슬롯 순서대로 텍스트 인코더에 이어 붙습니다. 노드는 `image_1`부터 `image_16`까지의 슬롯을 노출하며, 프롬프트는 인덱스로 이를 지정합니다. 예를 들어 `image_1`은 `<image1>`로 작성합니다
* **국소 편집**: 변경할 객체나 영역을 설명하면 이미지의 나머지 부분은 그대로 유지됩니다

**관련 링크**:

* [GitHub 저장소](https://github.com/QwenLM/Qwen-Image)
* [Hugging Face (ComfyUI 지원)](https://huggingface.co/Comfy-Org/Qwen-Image-2.1)
* [Comfy의 Qwen 이미지 2.1](https://comfy.org/qwen-image-2.1/)

## Qwen-Image-2.1 워크플로

<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>

<h3 id="image_qwen_image_2_1_t2i">
  Qwen Image 2.1 텍스트 기반 이미지 생성
</h3>

선택한 화면 비율과 메가픽셀 목표에 맞춰 텍스트 프롬프트로 이미지를 생성합니다.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_qwen_image_2_1_t2i-1.webp" alt="Qwen-Image-2.1 텍스트 기반 이미지 생성 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_qwen_image_2_1_t2i.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "Qwen-Image-2.1"을 검색하세요
  </Card>

  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=image_qwen_image_2_1_t2i&utm_source=docs&utm_medium=referral&utm_campaign=qwen-image-2-1">
    복잡한 설정 없이 온라인에서 ComfyUI를 실행하세요
  </Card>
</CardGroup>

**출력 예시**

![Qwen-Image-2.1 텍스트 기반 이미지 생성 예시 출력](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/Qwen_image_2.1.png)

<h3 id="image_qwen_image_2_1_image_edit">
  Qwen Image 2.1 이미지 편집
</h3>

지시문으로 이미지를 편집합니다. 소스 이미지에 없는 콘텐츠가 편집에 필요할 때는 참조 이미지를 추가하세요. 예를 들어 두 번째 사진의 의상을 첫 번째 사진 속 인물에게 입히는 경우입니다.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_qwen_image_2_1_image_edit-1.webp" alt="Qwen-Image-2.1 이미지 편집 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_qwen_image_2_1_image_edit.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "Qwen-Image-2.1"을 검색하세요
  </Card>

  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=image_qwen_image_2_1_image_edit&utm_source=docs&utm_medium=referral&utm_campaign=qwen-image-2-1">
    복잡한 설정 없이 온라인에서 ComfyUI를 실행하세요
  </Card>
</CardGroup>

**입력 자료**

다음 파일을 해당 `LoadImage` 노드에 업로드하세요:

<CardGroup cols={2}>
  <Card title="portrait_model_denim.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/portrait_model_denim.png">
    `LoadImage` 노드 470 · `portrait_model_denim.png`
  </Card>

  <Card title="clothing_light_blue_denim_shirt.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/clothing_light_blue_denim_shirt.png">
    `LoadImage` 노드 475 · `clothing_light_blue_denim_shirt.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/portrait_model_denim.png" alt="입력 이미지" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />

  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_qwen_image_2_1_image_edit.png" alt="Qwen-Image-2.1 이미지 편집 예시 출력" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

## 모델 링크

두 워크플로는 동일한 파일을 불러옵니다. 두 템플릿 모두 기본적으로 int8 버전의 diffusion 모델을 사용합니다.

**text\_encoders**

* [qwen3vl\_8b\_bf16.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/text_encoders/qwen3vl_8b_bf16.safetensors)

**diffusion\_models**

* [qwen\_image\_2.1\_int8\_convrot.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/diffusion_models/qwen_image_2.1_int8_convrot.safetensors) (템플릿이 기본으로 불러오며 메모리 사용량이 더 적습니다)
* [qwen\_image\_2.1\_bf16.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/diffusion_models/qwen_image_2.1_bf16.safetensors) (전체 정밀도, 더 많은 메모리가 필요합니다)

**vae**

* [qwen\_image\_2.1\_vae\_bf16.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/vae/qwen_image_2.1_vae_bf16.safetensors)

**모델 저장 위치**

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 text_encoders/
│   │      └── qwen3vl_8b_bf16.safetensors
│   ├── 📂 diffusion_models/
│   │      ├── qwen_image_2.1_int8_convrot.safetensors
│   │      └── qwen_image_2.1_bf16.safetensors
│   └── 📂 vae/
│          └── qwen_image_2.1_vae_bf16.safetensors
```

## 워크플로 설정

### 샘플러 설정

두 템플릿 모두 `steps` 25, `cfg` 1, `euler` 샘플러, `simple` scheduler로 샘플링합니다. 텍스트 기반 이미지 생성 워크플로는 시드를 고정하고, 이미지 편집 워크플로는 시드를 무작위로 설정합니다.

### 해상도

**텍스트 기반 이미지 생성**: **해상도 선택기** 노드가 화면 비율(1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 21:9)과 메가픽셀 목표값을 설정하며, 여기서 1.0 MP는 약 1024x1024입니다. 템플릿은 기본적으로 1 MP의 1:1로 설정됩니다. Qwen-Image-2.1은 2K로 네이티브 생성하므로, 2048x2048 정사각형 출력에는 목표값을 약 4.0 MP로 설정하세요.

**이미지 편집**: 템플릿 기본값인 `custom_size` 끄기 상태에서는 출력이 `image_1`의 화면 비율을 따르며, 약 `resolution` x `resolution` 픽셀(기본 1024, 32의 배수로 반올림)로 조정됩니다. 이는 `image_1`의 원본 픽셀 크기가 아닙니다. 각 참조 이미지를 32의 배수로 반올림한 자체 크기로 유지하려면 `resolution`을 0으로 설정하세요. 대신 **해상도 선택기** 캔버스를 사용하려면 `custom_size`를 켜고, 크기를 조정된 `image_1` 크기에 가깝게 유지하세요. 그렇지 않으면 편집 결과가 어긋날 수 있습니다.

### 이미지 편집 프롬프트 작성

참조 이미지는 슬롯 순서대로 텍스트 인코더에 삽입되며, 프롬프트는 각 이미지를 인덱스로 지칭합니다. 템플릿 프롬프트가 이 패턴의 좋은 예입니다:

```
Keep the character and pose in <image1> unchanged, put this light blue denim shirt from <image2> on the character, preserve the original facial features, hair, body shape and pose
```

### KV 캐시

이미지 편집 워크플로에는 **Qwen Image 2.1 Cache** 노드가 포함되어 있으며, 이 노드는 캐시된 텍스트와 참조 프리픽스가 저장되는 위치를 설정합니다:

| 설정       | 값                                | 효과                                                                                                                                 |
| -------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `device` | `auto`(기본값), `gpu`, `cpu`, `off` | `auto`는 남는 VRAM을 사용한 뒤 RAM을 사용합니다. `cpu`는 연산 뒤에서 프리페치되며 속도 손실이 거의 없습니다. `off`는 매 스텝마다 프리픽스를 다시 계산하므로 더 느리지만, 디버깅할 때 캐시를 배제할 수 있습니다 |
| `dtype`  | `default`(기본값), `int8`, `int4`   | 저장 정밀도입니다. `default`는 무손실이고, `int8`은 bf16 정도의 정확도로 캐시를 절반으로 줄이며, `int4`는 4분의 1로 줄이지만 스텝당 오류가 대략 두 배가 됩니다                           |