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

# IdeogramV3 - ComfyUI Built-in Node Documentation

> Complete documentation for the IdeogramV3 node in ComfyUI. Learn its inputs, outputs, parameters and usage.

# Ideogram V3

Ideogram V3 노드는 Ideogram V3 모델을 사용하여 이미지를 생성합니다. 텍스트 프롬프트로 일반 이미지 생성과 이미지와 마스크가 모두 제공될 때의 이미지 편집을 모두 지원합니다. 이 노드는 화면 비율, 해상도, 생성 속도 및 선택적 캐릭터 참조 이미지에 대한 다양한 제어 기능을 제공합니다.

## 입력

| 매개변수         | 설명                                                             | 데이터 타입 | 필수 여부 | 범위                                                                                                                                                      |
| ------------ | -------------------------------------------------------------- | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `프롬프트`       | 이미지 생성 또는 편집을 위한 프롬프트 (기본값: 비어 있음)                             | STRING | 예     | -                                                                                                                                                       |
| `이미지`        | 이미지 편집을 위한 선택적 참조 이미지                                          | IMAGE  | 아니요   | -                                                                                                                                                       |
| `마스크`        | 인페인팅을 위한 선택적 마스크 (흰색 영역이 대체됩니다)                                | MASK   | 아니요   | -                                                                                                                                                       |
| `종횡비`        | 이미지 생성의 화면 비율입니다. 해상도가 자동으로 설정되지 않은 경우 무시됩니다 (기본값: "1:1")      | COMBO  | 아니요   | "1:1"<br />"16:9"<br />"9:16"<br />"4:3"<br />"3:4"<br />"3:2"<br />"2:3"                                                                               |
| `해상도`        | 이미지 생성의 해상도입니다. 자동으로 설정되지 않은 경우 화면 비율 설정을 재정의합니다 (기본값: "Auto") | COMBO  | 아니요   | "Auto"<br />"1024x1024"<br />"1152x896"<br />"896x1152"<br />"1216x832"<br />"832x1216"<br />"1344x768"<br />"768x1344"<br />"1536x640"<br />"640x1536" |
| `매직 프롬프트 옵션` | 생성 시 MagicPrompt 사용 여부를 결정합니다 (기본값: "AUTO")                    | COMBO  | 아니요   | "AUTO"<br />"ON"<br />"OFF"                                                                                                                             |
| `시드`         | 생성을 위한 무작위 시드 (기본값: 0)                                         | INT    | 아니요   | 0-2147483647                                                                                                                                            |
| `이미지 수`      | 생성할 이미지 수 (기본값: 1)                                             | INT    | 아니요   | 1-8                                                                                                                                                     |
| `렌더링 속도`     | 생성 속도와 품질 간의 균형을 제어합니다 (기본값: "DEFAULT")                        | COMBO  | 아니요   | "DEFAULT"<br />"TURBO"<br />"QUALITY"                                                                                                                   |
| `캐릭터 이미지`    | 캐릭터 참조로 사용할 이미지                                                | IMAGE  | 아니요   | -                                                                                                                                                       |
| `캐릭터 마스크`    | 캐릭터 참조 이미지를 위한 선택적 마스크                                         | MASK   | 아니요   | -                                                                                                                                                       |

**매개변수 제약 조건:**

* `image`와 `mask`가 모두 제공되면 노드가 편집 모드로 전환됩니다
* `image` 또는 `mask` 중 하나만 제공되면 오류가 발생합니다
* `character_mask`를 사용하려면 `character_image`가 있어야 합니다
* `resolution`이 "Auto"로 설정되지 않은 경우 `aspect_ratio` 매개변수는 무시됩니다
* 마스크의 흰색 영역은 인페인팅 중에 대체됩니다
* 캐릭터 마스크와 캐릭터 이미지는 동일한 크기여야 합니다

## 출력

| 출력 이름    | 설명            | 데이터 타입 |
| -------- | ------------- | ------ |
| `output` | 생성되거나 편집된 이미지 | IMAGE  |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/IdeogramV3/ko.md)

***

**Source fingerprint (SHA-256):** `0d0058cc8483c453100d8d9dfcb9a31ae5e686f38ced77ed7e472cd083c3464b`