> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-willie-des-1087-router-migration-block.mintlify.site/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의 최신 텍스트 기반 이미지 생성 모델로, 뛰어난 사진과 같은 사실감, 정확한 텍스트 렌더링 및 정밀한 스타일 제어 기능을 제공합니다. 일반적인 자연어 또는 **구조화된 JSON 프롬프트**를 사용해 레이아웃, 색상 및 이미지 내 텍스트에 대한 세밀한 제어가 가능합니다.

## Ideogram 4.0이 뛰어난 점

* **사진 같은 사실적 품질**: 생성된 이미지 전반에 걸쳐 뛰어난 포토리얼리즘
* **정확한 텍스트 렌더링**: 이미지에 문자 그대로의 텍스트를 렌더링하며, 포스터와 같은 구성에 적합
* **정밀한 스타일 제어**: 구조화된 JSON 프롬프트가 스타일 팔레트, 요소 배치(`bbox`), 요소별 색상 팔레트를 제어
* **유연한 프롬프팅**: 빠른 아이디어를 위한 자연어 또는 세밀한 제어를 위한 구조화된 JSON을 허용
* **네거티브 프롬프트 불필요**: 별도의 네거티브 프롬프트 문자열 대신 비대칭 classifier-free 가이드를 사용

## 출력 예시

구조화된 JSON 프롬프트를 사용한 텍스트 기반 이미지 생성:

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

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

## 사용하기

<Card title="코드에서 호출하기" icon="code" href="/ko/development/comfy-router/models/ideogram/ideogram-v4/code">
  Comfy Router를 통해 HTTP로 호출하세요. 복사해서 붙여넣을 수 있는 Python, TypeScript, cURL 스니펫을 제공합니다.
</Card>

이 기능은 아래의 ComfyUI에서 실행하는 것과 동일한 Comfy 계정에서 실행되며, 동일한 크레딧으로 청구됩니다. 모델별 요금은 [파트너 노드 크레딧](/ko/tutorials/partner-nodes/pricing)을, 동시에 처리할 수 있는 요청 수는 [동시 실행 제한](/ko/tutorials/partner-nodes/concurrency-limits)을 참고하세요.

<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 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="클라우드 사용자">
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

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

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

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

![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 모델은 비대칭 classifier-free 가이드를 사용하며, 무조건부 패스에서 텍스트 토큰을 제거하므로 별도의 네거티브 프롬프트 문자열이 필요하지 않습니다.
* **모델 지원 프롬프트 구성**: ComfyUI에서 프롬프트 구성을 시각적으로 제어하려면 **Ideogram 4 Prompt Builder**(KJNodes) 사용을 고려해 보세요.