# Ideogram 4.5 Text to Image

Генерируйте изображения по текстовому промпту с помощью Ideogram 4.5. Промпт также принимает структурированную JSON-подпись Ideogram, например `final_prompt`, возвращённый предыдущим запуском, что даёт точный контроль над текстовыми строками, цветами и компоновкой. Узел возвращает сгенерированное изображение(я) вместе с подписью, на основе которой изображение фактически было сгенерировано.

## Входы

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `модель` | Модель для использования. (по умолчанию: `"ideogram-4.5"`) | DYNAMIC_COMBO | Да | `"ideogram-4.5"` |
| `prompt` | Текстовый промпт или структурированная JSON-подпись Ideogram, например предыдущий `final_prompt`. (по умолчанию: пустая строка) | 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 |

### Ограничения параметров

- **Промпт обязателен:** промпт должен содержать хотя бы один непробельный символ и не более 10000 символов. Установите `magic_prompt` в `"off"`, если передаёте собственную JSON-подпись или точную формулировку.
- **Размер:** `"auto"` позволяет модели выбрать. Пресеты `(2K)` дают от 3 до 4 мегапикселей, а `(1K)` около 1 мегапикселя; метка уровня описывает бюджет пикселей, а не фиксированную длинную сторону, а соотношение сторон пресета соблюдается. В API передаётся только часть пресета, отвечающая за размер в пикселях.
- **Воспроизводимость:** при `magic_prompt` в `"auto"` или `"on"` промпт переписывается при каждом запуске, поэтому один и тот же сид всё равно может дать другое изображение. Чтобы воспроизвести изображение, подайте его `final_prompt` обратно с `magic_prompt` в `"off"` и тем же сидом.
- **Безопасность контента:** если фильтр безопасности контента Ideogram блокирует генерацию, узел вызывает ошибку вместо возврата изображения.

## Выходы

| Имя выхода | Описание | Тип данных |
|-------------|-------------|-----------|
| `IMAGE` | Сгенерированное изображение(я) в виде батча. | IMAGE |
| `final_prompt` | Структурированная подпись, на основе которой было сгенерировано изображение. Подайте её обратно с `magic_prompt` в `"off"` и тем же сидом, чтобы воспроизвести изображение. | STRING |

> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/IdeogramTextToImageApi/ru.md)

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