> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-feat-openapi-i18n.mintlify.site/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 모델을 사용하여 이미지를 생성합니다. 텍스트 프롬프트로 일반 이미지 생성과 이미지와 마스크가 모두 제공될 때의 이미지 편집을 모두 지원합니다. 이 노드는 화면 비율, 해상도, 생성 속도 및 선택적 캐릭터 참조 이미지에 대한 다양한 제어 기능을 제공합니다.

## 입력

| 매개변수         | 설명                                                             | 데이터 타입 | 필수 여부 | 범위                                                                                                                                                      |
| ------------ | -------------------------------------------------------------- | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `프롬프트`       | 이미지 생성 또는 편집을 위한 프롬프트 (기본값: 비어 있음)                             | 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`