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

# Flux.3 Image Klein ComfyUI 가이드

> ComfyUI에서 FLUX.3 [klein]을 로컬로 실행: 오픈 웨이트 텍스트 기반 이미지 생성과 지시 기반 이미지 편집, 4~16스텝 증류판 포함.

## FLUX.3 \[klein] 정보

FLUX.3 \[klein]은 Black Forest Labs의 로컬 ComfyUI용 오픈 웨이트 FLUX.3 이미지 모델입니다. 텍스트 기반 이미지 생성과 지시 프롬프트 기반 이미지 편집을 한 패밀리에서 다루며, 전체 체크포인트와 가이드 없이 4\~16스텝으로 빠르게 샘플링하는 증류판을 제공합니다. 가중치는 FLUX Kommunity License로 Hugging Face에 공개되어 한 번 받으면 자체 GPU에서 실행할 수 있고, API 키나 이미지당 크레딧이 필요하지 않습니다.

호스티드 경로가 필요하면 Partner Node인 [FLUX 3 Image](/ko/tutorials/partner-nodes/black-forest-labs/flux-3-image)(이미지당 과금)도 있습니다. 자체 GPU면 로컬 klein 가중치, 다운로드 없이 쓰려면 Partner Node를 선택하세요.

**모델 하이라이트:**

* 동일한 가중치로 텍스트 기반 이미지 생성과 이미지 편집 가능. 편집은 지시 프롬프트와 참조 이미지로 구동
* 두 가지 체크포인트: 전체 Flux.3 Image Klein, 그리고 가이드 없이 4\~16스텝인 Distilled
* 프롬프트에서 `<ref_image_0>`, `<ref_image_1>` 등으로 다중 참조 지정
* 선택적 Qwen3.5 9B 프롬프트 업샘플러로 짧은 요청을 생성 전 완전한 캡션으로 확장
* bf16, int8(convrot), nvfp4 단일 파일 체크포인트, Qwen3-VL-4B 텍스트 인코더와 Flux 2 VAE

**라이선스**: [FLUX Kommunity License](https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy/blob/main/LICENSE.md)

**버전 요구 사항**: Flux.3 Klein 템플릿은 ComfyUI 0.41.0 이상이 필요하며, 0.41.1 백포트(ComfyUI#17070)로 제공됩니다.

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

## Flux.3 Image Klein 워크플로

<h3 id="image_flux3_klein_t2i">
  Flux.3 Image Klein: 텍스트 기반 이미지 생성
</h3>

입력 파일 없이 프롬프트만으로 이미지를 생성합니다. 이 워크플로는 서브그래프입니다. 열면 로더, 샘플러, 캔버스 크기에 접근할 수 있습니다.

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

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=image_flux3_klein_t2i&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-klein">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_flux3_klein_t2i.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "Flux.3 Image Klein: Text to Image" 검색
  </Card>
</CardGroup>

1. 서브그래프의 positive 프롬프트 위젯에 프롬프트를 입력합니다
2. `width`와 `height`를 설정하거나 `ResolutionSelector`에서 프레임을 선택합니다 (기본값은 1:1 정사각형)
3. `steps`(기본값 25)와 `cfg`(기본값 3.5)를 조정합니다. 더 나은 품질을 위해 50 steps를 시도해 보라는 안내가 템플릿에 포함되어 있습니다
4. 직접 작성한 문장으로 생성하려면 `enable_prompt_upsampler`를 꺼두고, 먼저 Qwen3.5 9B 업샘플러로 프롬프트를 확장하려면 켭니다
5. **실행 대기열**을 클릭합니다. 이미지는 `SaveImage` 노드에 의해 `ComfyUI/output/`에 저장됩니다

<h3 id="image_flux3_klein_distilled_t2i">
  Flux.3 Image Klein Distilled: 텍스트 기반 이미지 생성
</h3>

스텝 증류(step-distilled) checkpoint로 프롬프트에서 이미지를 생성합니다. 이 checkpoint는 15스텝으로, 가이드 없이 실행됩니다. 여기서는 프롬프트 업샘플링이 기본적으로 켜져 있으므로, 짧은 프롬프트가 샘플링 전에 완전한 캡션으로 확장됩니다.

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

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=image_flux3_klein_distilled_t2i&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-klein">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_flux3_klein_distilled_t2i.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "Flux.3 Image Klein Distilled: Text to Image" 검색
  </Card>
</CardGroup>

1. 프롬프트를 입력합니다. 템플릿이 먼저 업샘플링하므로 짧은 설명으로 충분합니다
2. `steps`를 4에서 16 사이로 설정합니다(기본값 15). 증류된 checkpoint는 `cfg` 1로 실행되므로 `cfg`를 높여도 도움이 되지 않습니다
3. `ResolutionSelector`에서 프레임을 선택합니다
4. **Queue**를 클릭해 생성합니다

**예시 출력**

![Flux.3 Image Klein Distilled 텍스트 기반 이미지 생성 예시](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_flux3_klein_distilled_t2i.png)

<h3 id="image_flux3_klein_image_edit">
  Flux.3 Image Klein: 이미지 편집
</h3>

원본 이미지를 참조로 연결한 상태에서 지시 프롬프트로 사진을 편집합니다. 지시문은 참조 콘텐츠를 대체합니다. 여기서는 프롬프트가 드레스 색상을 빨간색으로 바꾸고 나머지는 모두 그대로 유지합니다.

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

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=image_flux3_klein_image_edit&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-klein">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_flux3_klein_image_edit.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "Flux.3 Image Klein: Image Edit"를 검색하세요
  </Card>
</CardGroup>

**입력 자료**

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

<CardGroup cols={2}>
  <Card title="fashion_portrait_blue_silk_gown_vis.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/fashion_portrait_blue_silk_gown_vis.png">
    `LoadImage` 노드 11 · `fashion_portrait_blue_silk_gown_vis.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/fashion_portrait_blue_silk_gown_vis.png" alt="fashion_portrait_blue_silk_gown_vis.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

1. `LoadImage` 노드에서 소스 이미지를 불러옵니다
2. `Set Reference Multi Latent`에 연결합니다. 첫 번째 참조는 프롬프트에서 `<ref_image_0>`이고, 다음은 `<ref_image_1>`이며, 이런 식으로 계속 이어집니다
3. 편집 내용을 결과에 대한 완전한 설명으로 작성합니다. 제공된 예시에서 긍정 프롬프트는 `change the dress color to red`입니다
4. 다른 출력 크기를 원한다면 `Empty Flux 2 Latent`(템플릿에서는 1024 x 1024)로 캔버스를 조정합니다
5. **실행 대기열**을 클릭합니다. `ImageCompare`가 입력과 결과를 나란히 보여줍니다

**예시 출력**

<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/fashion_portrait_blue_silk_gown_vis.png" alt="입력 이미지" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />

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

<h3 id="image_flux3_klein_distilled_image_edit">
  Flux.3 Image Klein Distilled: 이미지 편집
</h3>

스텝 증류 체크포인트로 이미지를 편집합니다: 참조 이미지 1개, 지시 프롬프트 1개, 16 스텝, 가이드 없음.

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

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=image_flux3_klein_distilled_image_edit&utm_source=docs&utm_medium=referral&utm_campaign=flux-3-klein">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_flux3_klein_distilled_image_edit.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "Flux.3 Image Klein Distilled: Image Edit"를 검색하세요
  </Card>
</CardGroup>

**입력 자료**

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

<CardGroup cols={2}>
  <Card title="woman_gold_earring_teal_top_portrait.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/woman_gold_earring_teal_top_portrait.png">
    `LoadImage` 노드 11 · `woman_gold_earring_teal_top_portrait.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/woman_gold_earring_teal_top_portrait.png" alt="woman_gold_earring_teal_top_portrait.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

1. 편집할 이미지를 로드하고 `Set Reference Multi Latent`에 연결합니다
2. 편집 프롬프트를 작성합니다. 함께 제공되는 예시는 귀걸이를 교체하고, 나타나서는 안 되는 것까지 포함해 새 귀걸이를 자세히 설명합니다
3. `steps`를 4에서 16 범위로 유지하고 `cfg`는 1로 둡니다
4. **실행 대기열**을 클릭하고 `ImageCompare`에서 입력과 결과를 비교합니다

## Flux.3 Image Klein 모델 다운로드

<Note>
  Flux.3 Klein 가중치는 라이선스 동의가 필요한 저장소 [black-forest-labs/flux-3-image-klein-comfy](https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy) 에 있습니다. 페이지를 열어 라이선스에 동의한 뒤 파일을 다운로드하세요. 템플릿은 int8(convrot) 단일 파일 checkpoint를 사용하며, 같은 저장소에 bf16과 nvfp4 버전도 있습니다.
</Note>

<CardGroup cols={2}>
  <Card title="flux3_image_klein_int8_convrot.safetensors" icon="download" href="https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy">
    확산 모델, 전체 Flux.3 Image Klein checkpoint.
  </Card>

  <Card title="flux3_image_klein_sd_int8_convrot.safetensors" icon="download" href="https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy">
    확산 모델, 4\~16 스텝용 스텝 증류 checkpoint.
  </Card>

  <Card title="qwen3vl_4b_int8_convrot.safetensors" icon="download" href="https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy">
    두 checkpoint가 함께 사용하는 텍스트 인코더입니다. `CLIPLoader` 유형 `flux3`으로 불러오세요.
  </Card>

  <Card title="qwen3.5_9b_flux3_prompt_upsampler_int8_convrot.safetensors" icon="download" href="https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy">
    텍스트 기반 이미지 생성 템플릿에서 사용하는 프롬프트 업샘플러입니다.
  </Card>

  <Card title="flux2-vae.safetensors" icon="download" href="https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy">
    Flux.3 Klein의 VAE, 즉 Flux 2 VAE.
  </Card>
</CardGroup>

**모델 저장 위치**

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │      ├── flux3_image_klein_int8_convrot.safetensors
│   │      └── flux3_image_klein_sd_int8_convrot.safetensors
│   ├── 📂 text_encoders/
│   │      ├── qwen3vl_4b_int8_convrot.safetensors
│   │      └── qwen3.5_9b_flux3_prompt_upsampler_int8_convrot.safetensors
│   └── 📂 vae/
│          └── flux2-vae.safetensors
```

## 프롬프트 작성 및 레퍼런스 팁

* **변경 사항이 아니라 결과를 작성하세요.** 이미지 편집 템플릿은 편집 내용이 반영된 완성 이미지에 대한 전체 캡션을 기대하므로, 예시들도 "이것을 바꿔라"라고 말하는 대신 새로운 객체를 자세히 설명합니다.
* **레퍼런스는 두 conditioning 모두에 추가됩니다.** 추가 이미지를 `Set Reference Multi Latent`에 순서대로 연결하고, `<ref_image_0>`, `<ref_image_1>` 등으로 지칭한 다음, 레퍼런스 pipeline이 하는 방식대로 각각을 positive 프롬프트와 네거티브 프롬프트 양쪽에 추가하세요.
* **레퍼런스 크기는 비용을 조절하는 다이얼입니다.** 템플릿은 각 레퍼런스의 크기를 약 1메가픽셀로 조정하며, 출력 잠재 데이터는 그 크기를 갖습니다. Black Forest Labs 자체 pipeline이 약 16메가픽셀까지 유지하는 것처럼 레퍼런스를 원본 크기로 유지하면 비용이 더 높아지는 대신 편집 결과에 더 많은 디테일이 남습니다.
* **스텝 수는 checkpoint에 따라 다릅니다.** 전체 checkpoint는 템플릿에서 25 스텝, 가이드 3.5로 실행되며, 더 나은 품질을 위해 50 스텝을 시도해 보라는 안내가 있습니다. 스텝 증류(step-distilled) checkpoint는 15 또는 16 스텝에 가이드가 1로 고정되어 실행되며, 빠르게 처리하고 싶을 때 사용하는 것이 바로 이 checkpoint입니다.
* **템플릿에는 `Create Bounding Boxes` 노드가 포함되어 있습니다.** 이 노드는 소스 이미지 위에 박스를 그려 영역별 편집을 계획할 수 있게 해주며, 박스 목록은 `Preview Any` 노드에 표시되므로 해당 영역을 프롬프트에 반영할 수 있습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.