Easy Apply IPAdapter (Regional)(ipadapterApplyRegional)

The Easy Apply IPAdapter (Regional) node applies an IPAdapter to an Easy-Use pipeline, using a reference image and optional mask to control where and how the adapter influences the result. It also accepts positive/negative prompt text and independent weight controls for the image and prompt components. It lives in the EasyUse/Adapter category.

Description

This node adds IPAdapter-based regional guidance to a PIPE_LINE. In contrast to a plain global IPAdapter apply, the regional variant lets you supply text prompts and a mask so the adapter can be targeted to a specific area or used with prompt-aware regional conditioning. It outputs an updated pipe, an IPADAPTER_PARAMS object for further use, and positive/negative conditioning outputs.

Inputs

Required

• pipe (PIPE_LINE): The Easy-Use pipeline containing the active model, CLIP, VAE, and other sampler state. The node updates this pipe with the newly generated conditioning and IPAdapter parameters.
• image (IMAGE): The reference image used by the IPAdapter. The adapter learns or extracts the visual style/content information from this image and applies it to the generation.
• positive (STRING, default: ""): Positive prompt text used with the regional IPAdapter application. This is encoded and combined into the positive conditioning output.
• negative (STRING, default: ""): Negative prompt text used with the regional IPAdapter application. This is encoded and combined into the negative conditioning output.
• image_weight (FLOAT, default: 1, range: -1 to 3, step: 0.05): Controls how strongly the reference image influences the result. Negative values can be used to invert or counteract the image influence.
• prompt_weight (FLOAT, default: 1, range: 0 to 10, step: 0.05): Controls how strongly the supplied prompt text influences the result.
• weight_type (COMBO): Determines how the IPAdapter weight is applied. The available options follow the standard IPAdapter weight behavior, such as easing curves or style/composition weighting modes.
• start_at (FLOAT, default: 0, range: 0 to 1, step: 0.001): The denoising step at which the IPAdapter effect begins. A value of 0 starts applying it from the beginning of the sampling process.
• end_at (FLOAT, default: 1, range: 0 to 1, step: 0.001): The denoising step at which the IPAdapter effect stops. A value of 1 keeps it active through the end of the sampling process.

Optional

• mask (MASK, optional): A mask that defines the region where the IPAdapter should be applied. When provided, the adapter effect is restricted or focused according to the mask. When omitted, the adapter applies globally or with the default regional behavior.
• optional_ipadapter_params (IPADAPTER_PARAMS, optional): Existing IPAdapter parameters that can be passed in to override or augment the widget settings. This is useful for chaining or reusing adapter configurations.

Outputs

• PIPE_LINE: The updated Easy-Use pipeline with the IPAdapter regional conditioning and parameters applied, ready to be passed to a sampler or further pipeline nodes.
• IPADAPTER_PARAMS: The IPAdapter parameter object built by this node, which can be reused in other IPAdapter-compatible nodes.
• CONDITIONING: The positive conditioning output, including the encoded positive prompt and the regional IPAdapter influence.
• CONDITIONING: The negative conditioning output, including the encoded negative prompt and the corresponding IPAdapter negative influence.

Usage Notes

• Leave positive or negative empty if you do not want that prompt text to contribute.
• Use image_weight and prompt_weight independently to balance the visual reference against the text prompt.
• To restrict IPAdapter influence to only part of the image, provide a mask. If no mask is supplied, the node applies the adapter without a spatial region restriction.
• The start_at / end_at range lets you apply the adapter only during a specific portion of the denoising schedule, which can help preserve structure early or add fine detail late.
• If you already have an IPADAPTER_PARAMS object from another node or a previous call, pass it into optional_ipadapter_params to keep advanced settings intact.