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

# IdeogramTextToImageApi - ComfyUI Built-in Node Documentation

> Ideogram 4.5로 텍스트 프롬프트에서 이미지를 생성합니다. 이 프롬프트는 Ideogram 구조화 JSON 캡션도 받을 수 있습니다. 예를 들어 이전 실행에서 반환된 finalprompt를 사용하면 텍스트 문자열, 색상 및 레이아웃을 정확하게 제어할 수 있습니다. 이 노드는 생성된 이미지와 이미지가 실제로 생성

Ideogram 4.5로 텍스트 프롬프트에서 이미지를 생성합니다. 이 프롬프트는 Ideogram 구조화 JSON 캡션도 받을 수 있습니다. 예를 들어 이전 실행에서 반환된 `final_prompt`를 사용하면 텍스트 문자열, 색상 및 레이아웃을 정확하게 제어할 수 있습니다. 이 노드는 생성된 이미지와 이미지가 실제로 생성된 기준이 된 캡션을 함께 반환합니다.

## 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `모델` | 사용할 모델입니다. (기본값: `"ideogram-4.5"`) | DYNAMIC\_COMBO | 예 | `"ideogram-4.5"` |
| `prompt` | 텍스트 프롬프트 또는 이전 `final_prompt`와 같은 Ideogram 구조화 JSON 캡션입니다. (기본값: 빈 문자열) | STRING | 예 | 1  \~  10000자 |
| `size` | 출력 크기입니다. `"auto"`는 모델이 프롬프트에 맞는 캔버스를 선택하도록 합니다. `(2K)` 또는 `(1K)` 프리셋은 픽셀 크기와 화면 비율을 모두 고정합니다. (기본값: `"auto"`) | COMBO | 예 | `"auto"`<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) 1296x3168 (9:22)"`<br />`"(2K) 3168x1296 (22:9)"`<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 />`"(1K) 720x1280 (9:16)"`<br />`"(1K) 1280x720 (16:9)"`<br />`"(1K) 720x1440 (1:2)"`<br />`"(1K) 1440x720 (2:1)"` |
| `quality` | 품질 등급입니다. 등급이 높을수록 비용이 더 많이 들고 시간이 더 오래 걸립니다. (기본값: `"medium"`) | COMBO | 예 | `"low"`<br />`"medium"`<br />`"high"` |
| `magic_prompt` | 생성 전에 프롬프트를 상세한 구조화 캡션으로 다시 작성합니다. `"off"`는 입력한 문구를 가능한 한 그대로 유지합니다. 캡션은 `final_prompt`로 반환됩니다. (기본값: `"auto"`) 고급 설정입니다. | COMBO | 예 | `"auto"`<br />`"on"`<br />`"off"` |
| `seed` | 생성용 시드입니다. 텍스트-투-이미지는 매 실행마다 프롬프트가 다시 작성되므로 시드만으로는 재현할 수 없습니다. 이미지를 재현하려면 해당 `final_prompt`를 `magic_prompt`가 `"off"`로 설정된 상태에서 동일한 시드와 함께 재사용하십시오. (기본값: 42) | INT | 예 | 0  \~  2147483647 |

### 매개변수 제약

* **프롬프트 필수:** 프롬프트에는 공백이 아닌 문자가 최소 1개, 최대 10000자가 포함되어야 합니다. 직접 JSON 캡션 또는 정확한 문구를 제공할 때는 `magic_prompt`를 `"off"`로 설정하십시오.
* **크기:** `"auto"`는 모델이 선택하도록 합니다. `(2K)` 프리셋은 약 300만\~400만 화소, `(1K)` 프리셋은 약 100만 화소입니다. 등급 라벨은 고정된 긴 변이 아니라 화소 예산을 나타냅니다. 프리셋의 화면 비율이 유지됩니다. API에는 프리셋의 픽셀 크기 부분만 전송됩니다.
* **재현성:** `magic_prompt`가 `"auto"` 또는 `"on"`으로 설정된 경우 매 실행마다 프롬프트가 다시 작성되므로 동일한 시드로도 다른 이미지가 생성될 수 있습니다. 이미지를 재현하려면 해당 `final_prompt`를 `magic_prompt`가 `"off"`로 설정된 상태에서 동일한 시드와 함께 다시 입력하십시오.
* **콘텐츠 안전:** Ideogram의 콘텐츠 안전 필터가 생성을 차단하면 노드는 이미지를 반환하는 대신 오류를 발생시킵니다.

## 출력

| 출력 이름 | 설명 | 데이터 타입 |
| - | - | - |
| `IMAGE` | 생성된 이미지(들)을 배치로 나타냅니다. | IMAGE |
| `final_prompt` | 이미지가 생성된 기준이 된 구조화 캡션입니다. 이미지를 재현하려면 이를 `magic_prompt`가 `"off"`로 설정된 상태에서 동일한 시드와 함께 다시 입력하십시오. | STRING |

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

***

**Source fingerprint (SHA-256):** `a21f1faed9ca7a7bc63dae74003cc7599f11013075f718af9e5860d2cd666828`


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