Nodo Easy Apply InstantID para ComfyUI(instantIDApply)

Este nodo aplica la preservación de identidad de InstantID dentro de un pipeline EasyUse. Toma una imagen de rostro, un modelo InstantID seleccionado, un ControlNet opcional y un análisis facial basado en InsightFace para inyectar información de identidad en el modelo y producir un acondicionamiento positivo/negativo adecuado para el muestreo.

Entradas

Requerido

• pipe (PIPE_LINE): El estado del pipeline que contiene el modelo, el acondicionamiento y otros datos de muestreo. El nodo actualiza este pipeline con el adaptador InstantID aplicado.
• image (IMAGE): La imagen de rostro utilizada para extraer el embedding de identidad para InstantID.
• instantid_file (COMBO): Selecciona el archivo del modelo InstantID que se utilizará entre los archivos disponibles.
• insightface (COMBO): El backend de dispositivo utilizado para el análisis facial de InsightFace. Opciones: CPU, CUDA, ROCM. Elige el backend que coincida con tu hardware disponible.
• control_net_name (COMBO): Selecciona el archivo del modelo ControlNet que se utilizará para la orientación de estructura/pose junto con InstantID.
• cn_strength (FLOAT): Intensidad del ControlNet aplicado. Valor predeterminado: 1.0, rango: 0.0 a 10.0.
• cn_soft_weights (FLOAT): Pesos suaves para la contribución del ControlNet. Valor predeterminado: 1.0, rango: 0.0 a 1.0.
• weight (FLOAT): Intensidad general del adaptador de identidad de InstantID. Valor predeterminado: 0.8, rango: 0.0 a 5.0.
• start_at (FLOAT): La fracción del proceso de denoising en la que el acondicionamiento de InstantID/ControlNet comienza a surtir efecto. Valor predeterminado: 0.0, rango: 0.0 a 1.0.
• end_at (FLOAT): La fracción del proceso de denoising en la que el acondicionamiento de InstantID/ControlNet deja de surtir efecto. Valor predeterminado: 1.0, rango: 0.0 a 1.0.
• noise (FLOAT): Cantidad de ruido aplicada al embedding de acondicionamiento/identidad. Valor predeterminado: 0.35, rango: 0.0 a 1.0, paso: 0.05.

Opcional

• image_kps (IMAGE): Imagen opcional de keypoints/pose utilizada como entrada de keypoints para el ControlNet en la orientación de estructura.
• mask (MASK): Máscara opcional que limita el efecto de InstantID a una región específica de la imagen.
• control_net (CONTROL_NET): Modelo ControlNet precargado opcional. Cuando se proporciona, puede anular el modelo seleccionado mediante control_net_name.

Salidas

• PIPE_LINE: El estado del pipeline actualizado con el acondicionamiento de InstantID aplicado.
• MODEL: El modelo parcheado con el adaptador InstantID y el ControlNet aplicados.
• CONDITIONING: Acondicionamiento positivo que contiene la información de identidad de InstantID.
• CONDITIONING: Acondicionamiento negativo para usar durante el muestreo.

Notas de uso

• Usa las salidas de acondicionamiento positivo y negativo al muestrear con el modelo devuelto.
• El parámetro image debe contener una imagen de rostro clara para una extracción fiable de la identidad.
• Si se proporciona image_kps, se puede usar para transferir información de pose/estructura por separado de la imagen de identidad.
• Los valores start_at y end_at te permiten controlar cuándo está activa la orientación de InstantID/ControlNet durante el denoising, lo que resulta útil para equilibrar la fidelidad de la identidad con la composición general.
• Seleccionar el backend insightface correcto es importante para el rendimiento y la compatibilidad. Usa CUDA o ROCM cuando haya aceleración GPU disponible, o CPU como respaldo.