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

# Qwen3.5 ComfyUI 워크플로우 예시

> Qwen3.5는 이미지 이해 및 텍스트 생성 기능을 갖춘 알리바바 클라우드의 오픈소스 다모달 LLM으로, 이미지 캡션과 리버스 프롬프트 엔지니어링용 4B 크기 모델이 제공됩니다.

<Tip>
  <Tabs>
    <Tab title="휴대용 또는 자체 배포 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

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

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

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

    <Tab title="데스크톱 또는 클라우드 사용자">
      * 데스크톱 버전은 ComfyUI 안정판 기반으로, 새로운 데스크톱 안정판이 출시되면 자동으로 업데이트됩니다.
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

**Qwen3.5**는 알리바바 클라우드의 오픈소스 다모달 LLM으로, Qwen 3.0 시리즈를 기반으로 이미지 이해 기능을 추가했습니다. 텍스트 생성뿐 아니라 이미지 캡션과 리버스 프롬프트 엔지니어링과 같은 이미지 기반 작업도 지원합니다.

**모델 주요 특징**:

* **다모달** — 시각적 이해 작업을 위해 텍스트와 이미지 입력을 모두 수용합니다.
* **이미지 캡션** — 이미지를 설명하고 상세한 캡션을 생성할 수 있습니다.
* **리버스 프롬프트 엔지니어링** — 참조 이미지에서 프롬프트와 생성 파라미터를 추출합니다.
* **ComfyUI 기본 제공** — 내장된 `TextGenerate` 노드와 함께 작동하며, 커스텀 노드가 필요하지 않습니다.
* **경량성** — 4B 파라미터 모델로, 소비자용 GPU에 적합합니다.

## 사용 사례

Qwen3.5는 시각적 이해와 텍스트 생성을 결합해 ComfyUI 워크플로우에 가치를 더하는 시나리오에서 뛰어난 성능을 발휘합니다:

* **이미지 리버스 프롬프트 엔지니어링** — 참조 이미지를 Qwen3.5에 입력하고, 해당 이미지를 재현할 수 있는 상세한 텍스트 프롬프트를 생성하도록 요청하세요. 이는 멋진 이미지를 발견했지만 어떤 프롬프트로 생성되었는지 모르는 경우에 특히 유용합니다.
* **프롬프트 최적화** — 기존 프롬프트와 이미지 컨셉을 로드한 후, Qwen3.5에게 더 풍부한 세부 정보를 포함한 프롬프트를 생성하거나 개선, 확장하도록 요청하세요. 이렇게 하면 더 나은 생성 결과를 얻을 수 있습니다.
* **이미지 캡션 생성** — 생성된 이미지에 대한 캡션, 설명 또는 메타데이터 태그를 자동으로 생성하여 카탈로그화나 학습 데이터 준비에 유용하게 활용할 수 있습니다.
* **시각적 질문 응답** — 이미지 내용에 대한 질문("이 장면에는 어떤 물체가 있나요?", "배경 색깔은 무엇인가요?")을 던지고 구조화된 텍스트 답변을 받을 수 있습니다.
* **텍스트 읽기** — 적절한 프롬프트를 사용하면 이미지 속 보이는 텍스트나 라벨을 읽으려고 할 수 있지만, 신뢰성은 렌더링된 텍스트의 품질과 명확성에 따라 달라집니다.

## 이용 가능한 워크플로우

### Qwen3.5: 텍스트 생성

<Card title="워크플로우 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/llm_qwen3_5_text_gen.json">
  JSON 파일을 다운로드하거나 템플릿 라이브러리에서 "Qwen3.5 텍스트 생성"을 검색하세요.
</Card>

<Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=llm_qwen3_5_text_gen&utm_source=docs&utm_medium=referral&utm_campaign=qwen3_5">
  Comfy Cloud에서 열기
</Card>

![Qwen3.5 텍스트 생성 워크플로우](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/llm_qwen3_5_text_gen-1.webp)

이 워크플로우는 Qwen3.5의 **텍스트 생성 및 이미지 이해** 기능을 보여줍니다. 텍스트 프롬프트와 선택적 이미지를 받아들여 입력에 기반한 묘사 텍스트나 구조화된 분석을 생성합니다.

**입력**:

* **텍스트 프롬프트** — 질문, 지침 또는 작업 설명
* **이미지** (선택적) — 시각적 이해 작업용 (이미지 캡션, 리버스 프롬프트 엔지니어링, 프롬프트 최적화 등)

**주요 컨트롤**:

* **최대 길이** — 생성할 토큰의 최대 수 (기본값 256)
* **샘플링 모드** — 샘플링 켜기/끄기 및 온도, top-k, top-p, 반복 페널티, 시드 조정
* **기본 템플릿 사용** — 모델용 내장 시스템 프롬프트 적용

**출력**:

* **생성된 텍스트** — 모델의 응답을 일반 텍스트 문자열로 반환합니다.

<Card title="서브그래프 알아보기" icon="book-open" href="/ko/interface/features/subgraph">
  이 워크플로우는 서브그래프 노드를 사용해 모듈식 처리를 수행합니다. 서브그래프 문서를 확인해 워크플로우를 맞춤화하고 확장하는 방법을 배워보세요.
</Card>

## 모델 다운로드

Qwen3.5 모델은 ComfyUI에서 텍스트 인코더로 로드됩니다. 하드웨어에 가장 적합한 변형을 선택하세요:

<Card title="Qwen3.5 2B (bf16)" icon="download" href="https://huggingface.co/Comfy-Org/Qwen3.5/resolve/main/text_encoders/qwen3.5_2b_bf16.safetensors">
  경량형, 약 4.5GB. 낮은 VRAM 환경과 빠른 다운로드에 최적입니다.
</Card>

<Card title="Qwen3.5 4B (bf16)" icon="download" href="https://huggingface.co/Comfy-Org/Qwen3.5/resolve/main/text_encoders/qwen3.5_4b_bf16.safetensors">
  균형 잡힌 크기와 품질. 대부분의 소비자용 GPU에 권장됩니다.
</Card>

<Card title="Qwen3.5 9B (bf16)" icon="download" href="https://huggingface.co/Comfy-Org/Qwen3.5/resolve/main/text_encoders/qwen3.5_9b_bf16.safetensors">
  가장 큰 변형, 약 19GB. 더 높은 품질의 출력을 제공하며, 더 많은 VRAM을 요구합니다.
</Card>

다운로드한 `.safetensors` 파일을 다음 위치에 저장하세요:

```
📂 ComfyUI/
├── 📂 models/
│   └── 📂 text_encoders/
│       └── qwen3.5_4b_bf16.safetensors   # 또는 2b / 9b 변형
```
