Easy Apply IPAdapter (ipadapterApply) - ComfyUI-Easy-Use

Описание

Нода Easy Apply IPAdapter (ipadapterApply) применяет IP-Adapter к модели диффузии за один шаг. Она оборачивает обычный pipeline IPAdapter: выбор пресета, опциональную силу LoRA, провайдер, планирование, кэширование и опциональную маску внимания. На выходе она возвращает модифицированную модель, которую можно подать напрямую в сэмплер.

Эта нода относится к категории EasyUse/Adapter.

Входы

Имя	Тип	Обязательно	По умолчанию	Описание
`model`	`MODEL`	Да	—	Модель диффузии, к которой будет применён IPAdapter.
`image`	`IMAGE`	Да	—	Референсное изображение, используемое адаптером. Для пресетов FaceID оно должно содержать лицо.
`preset`	`COMBO`	Да	—	Выбирает пресет IPAdapter для использования. Доступные варианты зависят от установленных пресетов и моделей.
`lora_strength`	`FLOAT`	Да	0.6	Сила LoRA, которую загружает выбранный пресет. Пресеты без LoRA игнорируют этот параметр.
`provider`	`COMBO`	Да	`CUDA`	Провайдер выполнения для компонентов адаптера. Варианты: `CPU`, `CUDA`, `ROCM`, `DirectML`, `OpenVINO`, `CoreML`.
`weight`	`FLOAT`	Да	1.0	Общий вес IPAdapter. Диапазон: от -1 до 3, шаг 0.05. Установите 0, чтобы отключить влияние адаптера.
`weight_faceidv2`	`FLOAT`	Да	1.0	Отдельный вес, применяемый, если выбранный пресет является FaceID v2. Диапазон: от -1 до 5, шаг 0.05. Игнорируется пресетами, отличными от FaceID v2.
`start_at`	`FLOAT`	Да	0.0	Доля шагов, с которой IPAdapter начинает применяться. Диапазон: от 0 до 1, шаг 0.001.
`end_at`	`FLOAT`	Да	1.0	Доля шагов, на которой IPAdapter перестаёт применяться. Диапазон: от 0 до 1, шаг 0.001.
`cache_mode`	`COMBO`	Да	`all`	Управляет тем, какие компоненты кэшируются между вызовами. Варианты: `insightface only`, `clip_vision only`, `ipadapter only`, `all`, `none`.
`use_tiled`	`BOOLEAN`	Да	`false`	Включает плиточное применение IPAdapter для снижения расхода памяти. Полезно для больших изображений, хотя результаты могут незначительно отличаться.
`attn_mask`	`MASK`	Нет	—	Опциональная маска для ограничения внимания IPAdapter.
`optional_ipadapter`	`IPADAPTER`	Нет	—	Существующий объект IPAdapter для повторного использования вместо создания нового на основе пресета.

Выходы

Тип	Описание
`MODEL`	Входная модель с применённым IPAdapter. Используйте её в сэмплере для генерации с активным адаптером.
`IMAGE`	Оригинальное входное референсное изображение, передаваемое без изменений.
`MASK`	Маска внимания из параметра `attn_mask`, пропускаемая без изменений; `None`, если маска не была указана.
`IPADAPTER`	Объект IPAdapter, созданный или используемый этой нодой; доступен для повторного использования в других нодах-адаптерах.

Примечания по использованию

При планировании по умолчанию (start_at=0.0, end_at=1.0) IPAdapter активен на всём диапазоне денойзинга. Уменьшение end_at применяет его только на ранних шагах, а увеличение start_at применяет его только позже.
weight: основной параметр силы. weight_faceidv2: дополнительное отдельное значение силы для пресетов FaceID v2.
lora_strength управляет LoRA, которую загружает выбранный пресет. Пресеты в стиле FaceID обычно включают такую LoRA, однако параметр не оказывает влияния на пресеты, которые её не содержат.
cache_mode полезен при пакетных запусках. Режим all кэширует все переиспользуемые компоненты, а режим none отключает кэширование и быстрее освобождает ресурсы.
use_tiled может помочь избежать ошибок нехватки памяти при работе с изображениями высокого разрешения. Поскольку плиточная обработка может изменить поведение внимания, сравните результаты, если важно качество результата.
Выходы IMAGE и MASK представляют собой сквозные значения для связывания в цепочку; это не сгенерированные изображения и не маски.
Если указать optional_ipadapter, нода может переиспользовать уже созданный IPAdapter вместо создания нового.

Easy Apply IPAdapter(ipadapterApply)

ipadapter Apply