# Ideogram 4.5: точное редактирование

Редактирование изображения с помощью текстового промпта с точным редактированием Ideogram 4.5: изменяется только то, что запрошено в промпте, нетронутые пиксели остаются идентичными, а результат сохраняет размер изображения 1. Изображение 1 — это изображение для редактирования, и до 4 дополнительных изображений можно подключить в качестве референсов. Отдельную область изображения 1 также можно редактировать независимо, выбрав её маской или ограничивающими рамками, при этом изображение возвращается в полном размере.

## Входы

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
|-----------|-------------|-----------|----------|-------|
| `модель` | Модель для использования. (по умолчанию: `"ideogram-4.5"`) | DYNAMIC_COMBO | Да | `"ideogram-4.5"` |
| `images` | Расширяемый слот: изображение 1 — это изображение для редактирования, а изображения 2–5 — необязательные референсы (`image_1` ... `image_5`). Ссылайтесь на них в промпте как @Image1, @Image2, ...; пакетный вход считается один раз за изображение. Каждое изображение должно иметь соотношение сторон от 1:6 до 6:1, за исключением того, что изображение 1 не проверяется на соотношение сторон, пока используется контекстное окно. | IMAGE | Да | от 1 до 5 изображений |
| `prompt` | Инструкции по редактированию. Поддерживает ссылки вида @Image1 на подключённые изображения. (по умолчанию: пустая строка) | STRING | Да | от 1 до 10000 символов |
| `quality` | Уровень качества. Более высокие уровни стоят дороже и занимают больше времени. (по умолчанию: `"medium"`) | COMBO | Да | `"very_low"`<br>`"low"`<br>`"medium"`<br>`"high"` |
| `seed` | Сид для генерации. Одни и те же изображения, промпт, настройки и сид дают одинаковый результат. (по умолчанию: 42) | INT | Да | от 0 до 2147483647 |
| `context_window` | Область изображения 1 для редактирования. `"none"` редактирует всё изображение. `"auto"` редактирует область вокруг `context_window_mask`, а `"custom"` — область из `context_window_bboxes`; оба варианта сохраняют изображение 1 в полном размере и оставляют остальную часть изображения без изменений. (по умолчанию: `"none"`) | COMBO | Нет | `"none"`<br>`"auto"`<br>`"custom"` |
| `context_window_bboxes` | Область изображения 1 для редактирования, например, выход узла Create Bounding Boxes. Требуется, когда `context_window` имеет значение `"custom"`; в противном случае не используется. Несколько рамок объединяются в одну область, которая расширяется как минимум до 256 пикселей с каждой стороны и соотношения сторон 6:1. Область может быть до 4608 пикселей с каждой стороны и около 4 MP (например, 2048x2048). | BOUNDING_BOX | Нет | - |
| `context_window_mask` | Белый цвет отмечает, что редактировать; область редактирования размещается вокруг него. Требуется, когда `context_window` имеет значение `"auto"`; в противном случае не используется. Маска должна содержать как белые (редактируемые), так и чёрные (сохраняемые) области. | MASK | Нет | - |

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

- **Количество изображений:** не менее 1 и не более 5 изображений; пакетный вход считается один раз за изображение. Изображение 1 — это изображение для редактирования, а изображения 2–5 — референсы. При использовании `context_window_mask` принимается не более 4 изображений, то есть изображение 1 и 3 референса.
- **Размер выхода:** результат сохраняет размер изображения 1, поэтому у этого узла нет входов размера, ширины или высоты. Это также верно, когда редактируется область: возвращается полное изображение, в котором изменена только область.
- **Соотношение сторон изображения:** каждое изображение должно быть не шире, чем в 6 раз превышать его высоту, и не выше, чем в 6 раз превышать его ширину (от 1:6 до 6:1). Изображение 1 освобождается от проверки, пока `context_window` имеет значение `"auto"` или `"custom"`, поскольку отправляется только его выбранная область.
- **Размер исходной области:** при использовании контекстного окна изображение 1 может быть до 8192x8192 пикселей (около 67 MP); более крупные исходные изображения вызывают ошибку. Без контекстного окна изображения размером более примерно 4 MP или 4608 пикселей по длинной стороне масштабируются перед отправкой.
- **Ограничения области:** область из `context_window_bboxes` может быть до 4608 пикселей с каждой стороны и около 4 MP; рамки, которые полностью находятся за пределами изображения 1, вызывают ошибку.
- **Теги промпта:** `@ImageN` сопоставляется без учёта регистра и не должен превышать количество подключённых изображений; промпт должен быть непустым (не только пробелы) и не длиннее 10000 символов.
- **Ограничение загрузки:** изображение 1, маска и референсы вместе должны укладываться в 50 MB загрузки Ideogram; изображение 1 при необходимости перекодируется в JPEG, и узел выдаёт ошибку, если оно всё ещё не укладывается.
- **Безопасность контента:** если фильтр безопасности контента Ideogram блокирует результат, узел выдаёт ошибку вместо возврата изображения.

## Выходы

| Имя выхода | Описание | Тип данных |
|-------------|-------------|-----------|
| `IMAGE` | Отредактированное изображение в виде пакета, размером с изображение 1. | IMAGE |

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

---
**Source fingerprint (SHA-256):** `84f042739a8d7bc1a4b268f6175be6a598b67d32b9311fdf204a923472f5fcc9`
