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

# IdeogramEditApi - ComfyUI Built-in Node Documentation

> Ideogram 4.5를 사용하여 텍스트 프롬프트의 안내를 받아 최대 5개의 이미지를 편집하거나 결합합니다. 이미지 1은 편집할 이미지이며, 그다음 이미지들은 선택적 참조입니다. 전체 이미지가 다시 렌더링되므로 결과의 크기나 종횡비가 변경될 수 있습니다. 변경되지 않은 픽셀을 그대로 유지하려면 대신 Ideogram 4.5

Ideogram 4.5를 사용하여 텍스트 프롬프트의 안내를 받아 최대 5개의 이미지를 편집하거나 결합합니다. 이미지 1은 편집할 이미지이며, 그다음 이미지들은 선택적 참조입니다. 전체 이미지가 다시 렌더링되므로 결과의 크기나 종횡비가 변경될 수 있습니다. 변경되지 않은 픽셀을 그대로 유지하려면 대신 Ideogram 4.5 Precise Edit를 사용하십시오.

## 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `모델` | 사용할 모델입니다. (기본값: `"ideogram-4.5"`) | DYNAMIC\_COMBO | 예 | `"ideogram-4.5"` |
| `images` | 확장 가능한 슬롯: 이미지 1은 편집할 이미지이고 이미지 2\~5는 선택적 참조입니다(`image_1` ... `image_5`). 프롬프트에서 @Image1, @Image2, ...로 참조하십시오. 배치 입력은 이미지당 한 번으로 계산됩니다. 각 이미지는 1:6에서 6:1 사이의 종횡비를 가져야 합니다. | IMAGE | 예 | 1  \~  5개 이미지 |
| `prompt` | 편집 지침입니다. 연결된 이미지에 대한 @Image1 스타일 참조를 지원합니다. (기본값: 빈 문자열) | STRING | 예 | 1  \~  10000자 |
| `size` | 출력 크기입니다. `"auto"`는 이미지와 프롬프트로부터 대략 2K 캔버스를 선택하고, `"source"`는 이미지 1의 크기를 유지하며(약 4 MP를 초과하는 이미지는 먼저 축소됩니다), 다른 종횡비의 프리셋은 장면을 재구성합니다. 아래의 너비와 높이를 사용하려면 `"custom"`을 선택하십시오. (기본값: `"auto"`) | COMBO | 예 | `"auto"`<br />`"source"`<br />`"(2K) 2048x2048 (1:1)"`<br />`"(2K) 1440x2880 (1:2)"`<br />`"(2K) 2880x1440 (2:1)"`<br />`"(2K) 1664x2496 (2:3)"`<br />`"(2K) 2496x1664 (3:2)"`<br />`"(2K) 1792x2240 (4:5)"`<br />`"(2K) 2240x1792 (5:4)"`<br />`"(2K) 1440x2560 (9:16)"`<br />`"(2K) 2560x1440 (16:9)"`<br />`"(2K) 1600x2560 (5:8)"`<br />`"(2K) 2560x1600 (8:5)"`<br />`"(2K) 1728x2304 (3:4)"`<br />`"(2K) 2304x1728 (4:3)"`<br />`"(2K) 1152x2944 (9:23)"`<br />`"(2K) 2944x1152 (23:9)"`<br />`"(2K) 1248x3328 (3:8)"`<br />`"(2K) 3328x1248 (8:3)"`<br />`"(2K) 1280x3072 (5:12)"`<br />`"(2K) 3072x1280 (12:5)"`<br />`"(2K) 1024x3072 (1:3)"`<br />`"(2K) 3072x1024 (3:1)"`<br />`"(1K) 1024x1024 (1:1)"`<br />`"(1K) 896x1120 (4:5)"`<br />`"(1K) 1120x896 (5:4)"`<br />`"(1K) 864x1152 (3:4)"`<br />`"(1K) 1152x864 (4:3)"`<br />`"(1K) 832x1248 (2:3)"`<br />`"(1K) 1248x832 (3:2)"`<br />`"(1K) 800x1280 (5:8)"`<br />`"(1K) 1280x800 (8:5)"`<br />`"custom"` |
| `width` | 사용자 지정 출력 너비(픽셀)입니다. `size`가 `"custom"`일 때만 사용됩니다. (기본값: 2048) | INT | 예 | 256  \~  4608 (단계: 32) |
| `height` | 사용자 지정 출력 높이(픽셀)입니다. `size`가 `"custom"`일 때만 사용됩니다. (기본값: 2048) | INT | 예 | 256  \~  4608 (단계: 32) |
| `quality` | 품질 등급입니다. 더 높은 등급은 비용이 더 많이 들고 시간이 더 오래 걸립니다. (기본값: `"medium"`) | COMBO | 예 | `"very_low"`<br />`"low"`<br />`"medium"`<br />`"high"` |
| `seed` | 생성용 시드입니다. 동일한 이미지, 프롬프트, 설정 및 시드는 동일한 결과를 제공합니다. (기본값: 42) | INT | 예 | 0  \~  2147483647 |

### 매개변수 제약 조건

* **이미지 수:** 이미지는 최소 1개, 최대 5개입니다. 배치 입력은 이미지당 한 번으로 계산됩니다. 이미지 1은 편집할 이미지이고 나머지는 참조입니다.
* **이미지 종횡비:** 모든 이미지는 너비가 높이의 6배를 초과하지 않아야 하며, 높이가 너비의 6배를 초과하지 않아야 합니다(1:6에서 6:1 사이).
* **프롬프트 태그:** `@ImageN`은 대소문자를 구분하지 않고 일치하며, 연결된 이미지 수를 초과해서는 안 됩니다. 프롬프트는 공백이 아니어야 하며 최대 10000자여야 합니다.
* **사용자 지정 크기:** `size`가 `"custom"`일 때만 사용됩니다. 너비 곱하기 높이는 4194304픽셀(2048x2048)을 초과해서는 안 되며, 긴 변은 짧은 변의 6배를 초과해서는 안 됩니다. 너비와 높이는 256에서 4608 사이여야 하며 32의 배수로 스냅됩니다.
* **업로드 크기 조정:** 약 4 MP보다 크거나 긴 변이 4608 px보다 큰 이미지는 전송되기 전에 축소됩니다.
* **콘텐츠 안전:** Ideogram의 콘텐츠 안전 필터가 결과를 차단하면 노드는 이미지를 반환하는 대신 오류를 발생시킵니다.

## 출력

| 출력 이름 | 설명 | 데이터 타입 |
| - | - | - |
| `IMAGE` | 편집되거나 결합된 이미지를 배치로 반환합니다. | IMAGE |

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

***

**Source fingerprint (SHA-256):** `58c189d65502373ff7b56f5f32d9f2e7ee8019fc58f1bbbb80abc859cf978f67`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.