> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-462120c.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의 최신 텍스트 기반 이미지 생성 모델로, 사용자의 하드웨어에서 완전히 실행되는 오픈소스 모델로 출시되었습니다. 뛰어난 사실적 품질, 정확한 텍스트 렌더링, 정밀한 스타일 제어를 제공합니다. 일반 자연어 또는 **구조화된 JSON 프롬프트**를 사용하여 레이아웃, 색상, 이미지 내 텍스트를 세밀하게 제어할 수 있습니다.

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

## Ideogram 4.0 텍스트 기반 이미지 생성 워크플로

<h3 id="image_ideogram4_t2i">
  Ideogram v4: 텍스트 기반 이미지 생성
</h3>

텍스트 프롬프트 또는 구조화된 JSON 설명을 입력하세요. Ideogram 4.0을 사용하여 정밀한 레이아웃, 색상, 스타일 제어로 이미지를 생성합니다.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_ideogram4_t2i-1.webp" alt="Ideogram 4.0 text-to-image workflow preview" />

<CardGroup cols={2}>
  <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>
</CardGroup>

**출력 예시**

![Ideogram 4.0 example output](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_ideogram4_t2i.png)

### 프롬프트 형식

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

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

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

워크플로 내부의 노트에 다음과 같이 설명되어 있습니다:

> 이 모델은 구조화된 JSON 캡션(장면 요약, 스타일 블록, 배경, 그리고 바운딩 박스와 16진수 색상 팔레트를 포함한 선택적 객체별 설명)으로 학습되었습니다. 공식 추론은 해당 스키마에 대해 프롬프트를 검증합니다.

### Ideogram 4.0 모델 다운로드

모든 재패키징된 모델 파일은 Hugging Face의 [Comfy-Org/Ideogram-4](https://huggingface.co/Comfy-Org/Ideogram-4)에서 찾을 수 있습니다.

<CardGroup cols={2}>
  <Card title="ideogram4_fp8_scaled.safetensors" icon="download" href="https://huggingface.co/Comfy-Org/Ideogram-4/blob/main/diffusion_models/ideogram4_fp8_scaled.safetensors">
    Ideogram 4.0용 diffusion 모델 (\~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/blob/main/diffusion_models/ideogram4_unconditional_fp8_scaled.safetensors">
    Ideogram 4.0용 무조건 diffusion 모델 (\~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/blob/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/blob/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/blob/main/split_files/vae/flux2-vae.safetensors">
    Ideogram 4.0용 VAE (\~335 MB). <code>models/vae/</code>에 배치
  </Card>
</CardGroup>

**모델 저장 위치**

```
📂 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="서브그래프 알아보기" icon="book-open" href="/ko/interface/features/subgraph">
    이 워크플로는 모듈식 처리를 위해 서브그래프 노드를 사용합니다. 사용자 정의 및 확장 방법은 서브그래프 문서를 참조하세요.
  </Card>
</CardGroup>

### 워크플로 단계

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

### 안전 필터에 대한 참고 사항

"Image blocked by safety filter"가 표시되면 이는 Ideogram 4.0의 내장 안전 필터입니다. JSON이 아닌(일반 텍스트) 프롬프트는 오탐지율이 더 높습니다. 구조화된 JSON 프롬프트를 사용하면 프롬프트가 차단될 가능성이 줄어듭니다.

자세한 내용은 [Ideogram 4 공식 프롬프팅 가이드](https://github.com/ideogram-oss/ideogram4/blob/main/docs/prompting.md#safety-filter)를 참조하세요.

## Ideogram & ComfyOrg 라이브 대화

Purz & Rob가 진행하는 Mohammad Norouzi(Ideogram CEO)와 Yoland Yan(ComfyOrg CEO)의 특별 라이브 대화입니다.

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