Easy Apply IPAdapter (From Params)(ipadapterApplyFromParams)

Узел Easy Apply IPAdapter (From Params) применяет модель IPAdapter к diffusion-модели с помощью готового объекта IPADAPTER_PARAMS. Это аналог обычных узлов Easy Apply IPAdapter, ориентированный на работу с параметрами: вместо настройки каждого параметра адаптера непосредственно в этом узле вы собираете настройки выше по конвейеру и передаёте их через ipadapter_params. Это делает рабочие процессы модульными и позволяет легко переиспользовать одни и те же настройки адаптера в разных моделях или экспериментах.

Входы

model

Базовая diffusion-модель, к которой будет применён IPAdapter. Выход MODEL представляет собой изменённую версию этой модели с применённым условием IPAdapter.

preset

Выбирает пресет IPAdapter для загрузки. Доступные варианты формируются пакетом и ComfyUI на основе установленных пресетов. Пресет определяет, какие веса IPAdapter и поведение по умолчанию будут использоваться при применении.

ipadapter_params

Объект IPADAPTER_PARAMS, содержащий настройки IPAdapter для применения. Создайте его выше по конвейеру с помощью соответствующего узла Params, а затем передайте сюда. Этот объект обычно содержит входное изображение, веса, проценты начала и окончания, а также другие параметры управления адаптером.

combine_embeds

Управляет тем, как объединяются эмбеддинги IPAdapter, когда присутствует несколько эмбеддингов.

• concat – конкатенация эмбеддингов.
• add – поэлементное сложение.
• subtract – вычитание одного эмбеддинга из другого.
• average – усреднение эмбеддингов.
• norm average – усреднение с последующей нормализацией результата.
• max – поэлементный максимум.
• min – поэлементный минимум.

Выберите метод, соответствующий желаемому результату: average и concat часто используются для смешивания стиля или внешнего вида, а add/subtract полезны для более явной арифметики эмбеддингов.

embeds_scaling

Управляет масштабированием тензоров эмбеддингов IPAdapter.

• V only – использует только визуальные признаки.
• K+V – использует признаки ключа (key) и значения (value).
• K+V w/ C penalty – использует ключи и значения со штрафом на количество cross-attention.
• K+mean(V) w/ C penalty – использует ключи и значения со средним пулингом (mean) со штрафом на количество cross-attention.

Значение по умолчанию V only является стандартным выбором для большинства моделей IPAdapter; остальные режимы доступны для согласования с конкретными вариантами IPAdapter или расширенной настройки.

cache_mode

Управляет тем, что кэшируется между последовательными применениями.

• insightface only (по умолчанию) – кэширует только модели insightface; это полезно для использования IPAdapter в задачах, связанных с лицами.
• clip_vision only – кэширует выходы CLIP vision.
• ipadapter only – кэширует загруженную модель IPAdapter.
• all – кэширует всё для максимальной скорости при повторных запусках.
• none – отключает кэширование для экономии памяти.

Выбирайте более высокий уровень кэширования при многократном использовании одного и того же адаптера. Используйте none, когда память ограничена или когда адаптер или пресет непредсказуемо меняются.

optional_ipadapter

Необязательный вход IPADAPTER. Если он прикреплён, используется этот предварительно загруженный IPAdapter вместо загрузки из preset. Это полезно, когда у вас уже есть IPAdapter, загруженный в другом узле, и вы хотите избежать повторной загрузки.

image_negative

Необязательный вход IMAGE для негативного эталонного изображения. При передаче он используется для создания негативных эмбеддингов IPAdapter, что помогает подавить перенос нежелательных признаков в результат.

Выходы

MODEL output

Изменённая diffusion-модель с применённым IPAdapter. Подключите её к сэмплеру или другому узлу, изменяющему модель.

IPADAPTER

Модель или пайплайн IPAdapter, который был использован. Его можно передавать в другие узлы, например, чтобы избежать повторной загрузки адаптера или выстроить цепочку дальнейших операций с адаптером.

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

• Этот узел ожидает уже созданный объект IPADAPTER_PARAMS. Если вам нужно задать все параметры непосредственно в узле, используйте другой узел Easy Apply IPAdapter.
• Входы preset и optional_ipadapter предоставляют два способа получить адаптер: выберите пресет для автоматической загрузки или подключите существующий IPAdapter, чтобы полностью обойти загрузку.
• При повторных генерациях с одним и тем же пресетом оставляйте cache_mode в значении all, чтобы избежать повторной загрузки моделей каждый раз. Если вы часто переключаете адаптеры, предпочтите insightface only или none.
• embeds_scaling и combine_embeds должны соответствовать значениям, ожидаемым вашей моделью или пресетом IPAdapter; несоответствующие настройки могут привести к ухудшению результатов.