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

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

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

Ideogram 4.0은 Ideogram에서 출시한 최신 텍스트 기반 이미지 생성 모델로, 완전히 자체 하드웨어에서 실행되는 오픈소스 모델입니다. 뛰어난 포토리얼리즘 품질, 정확한 텍스트 렌더링, 정밀한 스타일 제어를 제공합니다. 일반 자연어 또는 **구조화된 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 텍스트 기반 이미지 생성 워크플로

<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/`에 저장됩니다.

### 안전 필터 참고사항

"이미지가 안전 필터에 의해 차단되었습니다"라는 메시지가 표시되면 이는 Ideogram 4.0의 내장 안전 필터 때문입니다. JSON이 아닌(일반 텍스트) 프롬프트는 오탐률이 더 높습니다. 구조화된 JSON 프롬프트를 사용하면 프롬프트가 차단될 가능성이 줄어듭니다. 자세한 내용은 [Ideogram 4 공식 프롬프트 가이드](https://github.com/ideogram-oss/ideogram4/blob/main/docs/prompting.md#safety-filter)를 참조하세요.

## Ideogram & ComfyOrg 창립자 대담

Mohammad Norouzi(Ideogram CEO)와 Yoland Yan(ComfyOrg CEO)을 게스트로 초대한 특별 라이브 대담입니다. Purz와 Rob이 진행합니다.

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/gO-D5eO8VlA?si=ehD_qzll3yCzirpP" title="Ideogram 4.0 Live Conversation" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />