Nodo Easy Apply IPAdapter (Regional)(ipadapterApplyRegional)

El nodo Easy Apply IPAdapter (Regional) aplica un IPAdapter a un pipeline Easy-Use, utilizando una imagen de referencia y una máscara opcional para controlar dónde y cómo influye el adaptador en el resultado. También acepta texto de prompt positivo y negativo, y controles de peso independientes para los componentes de imagen y prompt. Se encuentra en la categoría EasyUse/Adapter.

Descripción

Este nodo añade orientación regional basada en IPAdapter a un PIPE_LINE. A diferencia de una simple aplicación global de IPAdapter, la variante regional permite proporcionar prompts de texto y una máscara para que el adaptador pueda dirigirse a un área específica o utilizarse con acondicionamiento regional sensible al prompt. Genera un pipe actualizado, un objeto IPADAPTER_PARAMS para uso posterior y salidas de acondicionamiento positivo y negativo.

Entradas

Requerido

• pipe (PIPE_LINE): El pipeline Easy-Use que contiene el modelo activo, CLIP, VAE y otro estado del muestreador. El nodo actualiza este pipe con el acondicionamiento recién generado y los parámetros de IPAdapter.
• image (IMAGE): La imagen de referencia utilizada por el IPAdapter. El adaptador aprende o extrae la información de estilo y contenido visual de esta imagen y la aplica a la generación.
• positive (STRING, valor predeterminado: ""): Texto de prompt positivo utilizado con la aplicación regional de IPAdapter. Se codifica y se combina en la salida de acondicionamiento positivo.
• negative (STRING, valor predeterminado: ""): Texto de prompt negativo utilizado con la aplicación regional de IPAdapter. Se codifica y se combina en la salida de acondicionamiento negativo.
• image_weight (FLOAT, valor predeterminado: 1, rango: -1 a 3, paso: 0.05): Controla la intensidad con la que la imagen de referencia influye en el resultado. Los valores negativos se pueden utilizar para invertir o contrarrestar la influencia de la imagen.
• prompt_weight (FLOAT, valor predeterminado: 1, rango: 0 a 10, paso: 0.05): Controla la intensidad con la que el texto de prompt proporcionado influye en el resultado.
• weight_type (COMBO): Determina cómo se aplica el peso del IPAdapter. Las opciones disponibles siguen el comportamiento estándar de peso de IPAdapter, como curvas de easing o modos de ponderación de estilo y composición.
• start_at (FLOAT, valor predeterminado: 0, rango: 0 a 1, paso: 0.001): El paso de denoising en el que comienza el efecto del IPAdapter. Un valor de 0 comienza a aplicarlo desde el inicio del proceso de muestreo.
• end_at (FLOAT, valor predeterminado: 1, rango: 0 a 1, paso: 0.001): El paso de denoising en el que se detiene el efecto del IPAdapter. Un valor de 1 lo mantiene activo hasta el final del proceso de muestreo.

Opcional

• mask (MASK, opcional): Una máscara que define la región donde se debe aplicar el IPAdapter. Cuando se proporciona, el efecto del adaptador queda restringido o enfocado según la máscara. Cuando se omite, el adaptador se aplica globalmente o con el comportamiento regional predeterminado.
• optional_ipadapter_params (IPADAPTER_PARAMS, opcional): Parámetros de IPAdapter existentes que se pueden pasar para anular o ampliar las configuraciones del widget. Esto es útil para encadenar o reutilizar configuraciones de adaptador.

Salidas

• PIPE_LINE: El pipeline Easy-Use actualizado con el acondicionamiento regional de IPAdapter y los parámetros aplicados, listo para pasarse a un muestreador o a otros nodos del pipeline.
• IPADAPTER_PARAMS: El objeto de parámetros de IPAdapter creado por este nodo, que se puede reutilizar en otros nodos compatibles con IPAdapter.
• CONDITIONING: La salida de acondicionamiento positivo, que incluye el prompt positivo codificado y la influencia regional del IPAdapter.
• CONDITIONING: La salida de acondicionamiento negativo, que incluye el prompt negativo codificado y la influencia negativa correspondiente del IPAdapter.

Notas de uso

• Deje positive o negative vacíos si no desea que ese texto de prompt contribuya.
• Utilice image_weight y prompt_weight de forma independiente para equilibrar la referencia visual con el prompt de texto.
• Para restringir la influencia del IPAdapter a solo una parte de la imagen, proporcione una máscara. Si no se suministra ninguna máscara, el nodo aplica el adaptador sin restricción de región espacial.
• El rango start_at / end_at permite aplicar el adaptador solo durante una porción específica del programa de denoising, lo que puede ayudar a preservar la estructura al principio o añadir detalles finos al final.
• Si ya tiene un objeto IPADAPTER_PARAMS de otro nodo o de una llamada anterior, páselo a optional_ipadapter_params para mantener intactas las configuraciones avanzadas.