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