Easy Apply IPAdapter（区域）节点(ipadapterApplyRegional)

Easy Apply IPAdapter（区域） 节点将 IPAdapter 应用于 Easy-Use 管道，使用参考图像和可选遮罩来控制适配器影响结果的位置和方式。它还接受正面/负面提示词文本，以及针对图像和提示组件的独立权重控制。它位于 EasyUse/Adapter 类别中。

描述

此节点向 PIPE_LINE 添加基于 IPAdapter 的区域引导。与普通的全局 IPAdapter 应用不同，区域变体允许您提供文本提示词和遮罩，以便适配器可以针对特定区域，或与提示感知的区域条件一起使用。它输出一个已更新的管道、一个供进一步使用的 IPADAPTER_PARAMS 对象，以及正面/负面条件输出。

输入

必填

• pipe（PIPE_LINE）：包含当前模型、CLIP、VAE 及其他采样器状态的 Easy-Use 管道。此节点使用新生成的条件和 IPAdapter 参数更新此管道。
• image（IMAGE）：IPAdapter 使用的参考图像。适配器从此图像中学习或提取视觉样式/内容信息，并将其应用于生成。
• positive（STRING，默认值：""）：用于区域 IPAdapter 应用的正面提示词文本。它会被编码并合并到正面条件输出中。
• negative（STRING，默认值：""）：用于区域 IPAdapter 应用的负面提示词文本。它会被编码并合并到负面条件输出中。
• image_weight（FLOAT，默认值：1，范围：-1 到 3，步长：0.05）：控制参考图像对结果的影响强度。负值可用于反转或抵消图像影响。
• prompt_weight（FLOAT，默认值：1，范围：0 到 10，步长：0.05）：控制所提供的提示词文本对结果的影响强度。
• weight_type（COMBO）：确定 IPAdapter 权重的应用方式。可用选项遵循标准 IPAdapter 权重行为，例如缓动曲线或样式/构图权重模式。
• start_at（FLOAT，默认值：0，范围：0 到 1，步长：0.001）：IPAdapter 效果开始生效的去噪步骤。值 0 表示从采样过程开始时即开始应用。
• end_at（FLOAT，默认值：1，范围：0 到 1，步长：0.001）：IPAdapter 效果停止的去噪步骤。值 1 表示在采样过程结束前保持生效。

可选

• mask（MASK，可选）：定义 IPAdapter 应用区域的遮罩。提供时，适配器效果将根据遮罩受限或聚焦。省略时，适配器将全局应用或采用默认的区域行为。
• optional_ipadapter_params（IPADAPTER_PARAMS，可选）：可传入以覆盖或增强控件设置的现有 IPAdapter 参数。这对于串联或复用适配器配置非常有用。

输出

• PIPE_LINE：已应用 IPAdapter 区域条件和参数的已更新 Easy-Use 管道，可传递给采样器或后续管道节点。
• IPADAPTER_PARAMS：此节点构建的 IPAdapter 参数对象，可在其他兼容 IPAdapter 的节点中复用。
• CONDITIONING：正面条件输出，包括编码后的正面提示词和区域 IPAdapter 影响。
• CONDITIONING：负面条件输出，包括编码后的负面提示词和相应的 IPAdapter 负面影响。

使用说明

• 如果不希望某个提示词文本生效，请将 positive 或 negative 留空。
• 独立使用 image_weight 和 prompt_weight，以平衡视觉参考与文本提示词。
• 要仅将 IPAdapter 影响限制在图像的一部分，请提供 mask。如果未提供遮罩，此节点将应用适配器而不进行空间区域限制。
• start_at / end_at 范围允许您仅在去噪过程的特定阶段应用适配器，这有助于在早期保留结构，或在后期添加精细细节。
• 如果您已经从另一个节点或上一次调用中获得了 IPADAPTER_PARAMS 对象，请将其传入 optional_ipadapter_params 以保持高级设置不变。