> ## 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 API 파트너 노드를 사용하는 방법을 알아보세요

Ideogram 4.0은 Ideogram의 최신 텍스트-to이미지 모델로, 뛰어난 사진과 같은 사실감, 정확한 텍스트 렌더링 및 정밀한 스타일 제어 기능을 제공합니다. 일반적인 자연어 또는 **구조화된 JSON 프롬프트**를 사용해 레이아웃, 색상 및 이미지 내 텍스트에 대한 세밀한 제어가 가능합니다.

<Tip>
  파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 [파트너 노드 개요](/ko/tutorials/partner-nodes/overview) 섹션을 참조해 주세요.
</Tip>

<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=api_ideogram_v4_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/api_ideogram_v4_t2i.json">
  JSON 다운로드 또는 템플릿 라이브러리에서 "Ideogram v4: Text to Image (API)" 검색
</Card>

![Ideogram 4.0 예시 출력](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_ideogram_v4_t2i.png)
*Ideogram 4.0 API의 예시 출력*

### 프롬프트 형식

Ideogram V4 노드는 두 가지 프롬프트 형식을 지원합니다:

1. **자연어** — 간단하고 직관적이며, 빠른 아이디어에 가장 적합합니다.
2. **구조화된 JSON** — 스타일 팔레트, 요소 배치(`bbox`), 이미지 내 문자열 렌더링 등에 대한 세밀한 제어가 가능합니다. 포스터와 같은 구성에 권장됩니다.

기본 워크플로우 예제는 다음과 같은 구조화된 JSON 프롬프트를 사용합니다:

* `high_level_description` — 전체 장면 설명
* `style_description` — 미학, 조명, 매체, 색상 팔레트
* `compositional_deconstruction` — 각 요소별 바운딩 박스, 설명 및 색상 팔레트

### 워크플로우 단계

1. 워크플로우 파일을 다운로드하여 ComfyUI로 드래그하세요.
2. `Ideogram V4` 노드에는 이미 기본 구조화된 JSON 프롬프트가 포함되어 있습니다—수정하거나 일반 자연어를 작성할 수 있습니다.
3. `Run`을 클릭하거나 단축키 `Ctrl(cmd) + Enter`를 사용해 이미지를 생성하세요.
4. API가 결과를 반환한 후, `Save Image` 노드에서 생성된 이미지를 확인하세요. 이미지는 `ComfyUI/output/` 디렉토리에 저장됩니다.

### JSON 프롬프트 빌더 사용하기 (선택사항)

워크플로우에는 구조화된 JSON 프롬프트를 만드는 데 도움을 주는 내장된 **Gemini** 노드(Gemini 3.1 Pro)가 포함되어 있습니다:

1. Gemini 노드의 사용자 프롬프트 필드에 아이디어를 설명하세요.
2. 모델이 스키마에 맞는 JSON 프롬프트를 생성합니다.
3. `STRING` 출력을 `Ideogram V4` 노드의 `prompt` 입력에 연결하세요.
4. 워크플로우를 실행하세요.

## 추가 참고사항

* **부정적 프롬프트는 필요하지 않습니다** — Ideogram 4.0 모델은 비대칭 분류기 없는 가이던스를 사용하며, 무조건적인 패스 과정에서 텍스트 토큰을 제거하는 방식으로 작동하므로 별도의 부정적 프롬프트 문자열이 필요하지 않습니다.
* **모델 지원 프롬프트 생성** — ComfyUI에서 프롬프트 구성을 시각적으로 제어하려면 **Ideogram 4 프롬프트 빌더**(KJNodes)를 사용해 보세요.

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