Easy Apply InstantID: нода для сохранения идентичности лица в ComfyUI(instantIDApply)

Эта нода применяет сохранение идентичности InstantID внутри пайплайна EasyUse. Она принимает изображение лица, выбранную модель InstantID, опциональный ControlNet и анализ лица на основе InsightFace, чтобы внедрить информацию об идентичности в модель и создать позитивное/негативное условие, подходящее для сэмплирования.

Входы

Обязательно

• pipe (PIPE_LINE): Состояние пайплайна, содержащее модель, условие и другие данные сэмплирования. Нода обновляет этот пайплайн с применённым адаптером InstantID.
• image (IMAGE): Изображение лица, используемое для извлечения эмбеддинга идентичности для InstantID.
• instantid_file (COMBO): Выбирает файл модели InstantID для использования из доступных файлов.
• insightface (COMBO): Бэкенд устройства, используемый для анализа лица InsightFace. Варианты: CPU, CUDA, ROCM. Выберите бэкенд, соответствующий вашему оборудованию.
• control_net_name (COMBO): Выбирает файл модели ControlNet для использования в качестве направления структуры/позы вместе с InstantID.
• cn_strength (FLOAT): Сила применённого ControlNet. По умолчанию 1.0, диапазон 0.0-10.0.
• cn_soft_weights (FLOAT): Мягкие веса для вклада ControlNet. По умолчанию 1.0, диапазон 0.0-1.0.
• weight (FLOAT): Общая сила адаптера идентичности InstantID. По умолчанию 0.8, диапазон 0.0-5.0.
• start_at (FLOAT): Доля процесса денойзинга, с которой условие InstantID/ControlNet начинает действовать. По умолчанию 0.0, диапазон 0.0-1.0.
• end_at (FLOAT): Доля процесса денойзинга, на которой условие InstantID/ControlNet перестаёт действовать. По умолчанию 1.0, диапазон 0.0-1.0.
• noise (FLOAT): Количество шума, применяемого к условию/эмбеддингу идентичности. По умолчанию 0.35, диапазон 0.0-1.0, шаг 0.05.

Необязательно

• image_kps (IMAGE): Необязательное изображение ключевых точек/позы, используемое как вход ключевых точек ControlNet для направления структуры.
• mask (MASK): Необязательная маска, ограничивающая эффект InstantID определённой областью изображения.
• control_net (CONTROL_NET): Необязательная предварительно загруженная модель ControlNet. При наличии может переопределить модель, выбранную через control_net_name.

Выходы

• PIPE_LINE: Обновлённое состояние пайплайна с применённым условием InstantID.
• MODEL: Модель с патчем, к которой применены адаптер InstantID и ControlNet.
• CONDITIONING: Позитивное условие, содержащее информацию об идентичности InstantID.
• CONDITIONING: Негативное условие для использования во время сэмплирования.

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

• Используйте выходы позитивного и негативного условия при сэмплировании с возвращённой моделью.
• Вход image должен быть чётким изображением лица для надёжного извлечения идентичности.
• Если указан image_kps, его можно использовать для переноса информации о позе/структуре отдельно от изображения идентичности.
• Значения start_at и end_at позволяют управлять тем, когда во время денойзинга активно направление InstantID/ControlNet. Это полезно для баланса между точностью идентичности и общей композицией.
• Выбор правильного бэкенда insightface важен для производительности и совместимости. Используйте CUDA или ROCM при наличии аппаратного ускорения GPU, либо CPU в качестве запасного варианта.