> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-mintlify-b90d3c69.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI Ideogram 4.0 오픈소스 모델 튜토리얼

> ComfyUI에서 Ideogram 4.0 오픈소스 모델을 사용하는 방법 알아보기

Ideogram 4.0은 Ideogram에서 출시한 최신 텍스트-to-이미지 모델로, 완전히 자체 하드웨어에서 실행되는 오픈소스 모델입니다. 이 모델은 뛰어난 포토리얼리즘 품질과 정확한 텍스트 렌더링, 정밀한 스타일 제어를 제공합니다. 일반적인 자연어 또는 **구조화된 JSON 프롬프트**를 사용해 레이아웃, 색상, 이미지 내 텍스트까지 세밀하게 제어할 수 있습니다.

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

## Ideogram 4.0 텍스트-to-이미지 워크플로우

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

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

![Ideogram 4.0 예제 출력](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_ideogram4_t2i.png)
*Ideogram 4.0 모델의 예제 출력*

### 프롬프트 형식

오픈소스 워크플로우는 두 가지 프롬프트 모드를 지원합니다:

1. **자연어** — 빠르고 간편하며, 단순한 아이디어에 가장 적합
2. **구조화된 JSON** — 레이아웃, 색상, 스타일을 정밀하게 제어하기 위한 방식

워크플로우에는 어떤 LLM과 함께 사용해도 일치하는 JSON 프롬프트를 생성할 수 있는 프롬프트 구성 템플릿이 포함되어 있습니다.

워크플로우 내부의 주석에는 다음과 같이 설명되어 있습니다:

> 이 모델은 구조화된 JSON 캡션(장면 요약, 스타일 블록, 배경 및 선택적 개체별 설명과 경계 상자 및 16진수 색상 팔레트)으로 학습되었습니다. 공식 추론에서는 해당 스키마에 맞게 프롬프트를 검증합니다.

### Ideogram 4.0 모델 다운로드

Hugging Face의 [Comfy-Org/Ideogram-4](https://huggingface.co/Comfy-Org/Ideogram-4)에서 모든 재포장된 모델 파일을 확인할 수 있습니다.

<Card title="ideogram4_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Ideogram-4/resolve/main/diffusion_models/ideogram4_fp8_scaled.safetensors">
  Ideogram 4.0용 디퓨전 모델 (\~13.8 GB). <code>models/diffusion\_models/</code>에 저장하세요
</Card>

<Card title="ideogram4_unconditional_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Ideogram-4/resolve/main/diffusion_models/ideogram4_unconditional_fp8_scaled.safetensors">
  Ideogram 4.0용 비조건 디퓨전 모델 (\~13.8 GB). <code>models/diffusion\_models/</code>에 저장하세요
</Card>

<Card title="qwen3vl_8b_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Qwen3-VL/resolve/main/text_encoders/qwen3vl_8b_fp8_scaled.safetensors">
  Ideogram 4.0용 텍스트 인코더 (\~8 GB). <code>models/text\_encoders/</code>에 저장하세요
</Card>

<Card title="gemma4_e4b_it_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/gemma-4/resolve/main/text_encoders/gemma4_e4b_it_fp8_scaled.safetensors">
  Ideogram 4.0용 텍스트 인코더 (\~2 GB). <code>models/text\_encoders/</code>에 저장하세요
</Card>

<Card title="flux2-vae.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/flux2-dev/resolve/main/split_files/vae/flux2-vae.safetensors">
  Ideogram 4.0용 VAE (\~335 MB). <code>models/vae/</code>에 저장하세요
</Card>

**모델 저장 위치**

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   ├── ideogram4_fp8_scaled.safetensors
│   │   └── ideogram4_unconditional_fp8_scaled.safetensors
│   ├── 📂 text_encoders/
│   │   ├── qwen3vl_8b_fp8_scaled.safetensors
│   │   └── gemma4_e4b_it_fp8_scaled.safetensors
│   └── 📂 vae/
│       └── flux2-vae.safetensors
```

<CardGroup cols={2}>
  <Card title="Subgraph 알아보기" icon="book-open" href="/ko/interface/features/subgraph">
    이 워크플로우는 모듈식 처리를 위해 Subgraph 노드를 사용합니다. Subgraph 문서를 확인해 사용자 지정 및 확장 방법을 알아보세요.
  </Card>
</CardGroup>

### 워크플로우 단계

1. 모델을 다운로드해 올바른 디렉터리에 저장하세요 (위 표 참조)
2. 워크플로우 파일을 다운로드해 ComfyUI로 드래그하세요
3. Ideogram4 서브그래프 노드에 프롬프트(자연어 또는 구조화된 JSON)를 입력하세요
4. (선택) `ResolutionSelector` 노드를 사용해 해상도를 조정하세요
5. `Run`을 클릭하거나 단축키 `Ctrl(cmd) + Enter`를 사용해 이미지를 생성하세요
6. 결과는 `Save Image` 노드에서 확인하세요 — 출력 파일은 `ComfyUI/output/`에 저장됩니다.

### 안전 필터 관련 주의사항

"안전 필터에 의해 이미지가 차단됨"이라는 메시지가 나타나면, 이는 모델 자체에 내장된 안전 훈련 때문입니다. ComfyUI는 별도의 안전 필터를 추가하지 않습니다. 내장된 안전 메커니즘을 피하도록 프롬프트를 조정해 보세요.