Easy Apply PuLID(applyPulID)

Easy Apply PuLID 使用参考人脸图像和可选的注意力遮罩，将 PuLID 身份适配器应用到模型上。它为适配器工作流提供了简单、单节点的接口：输入基础模型、PuLID 模型文件和人脸图像，并控制身份的注入强度。

输入

• model (MODEL)：将应用 PuLID 适配器的基础扩散模型。
• pulid_file (COMBO)：要加载的 PuLID 模型文件。选择节点自带或配置的可用 .safetensors/模型文件之一。
• insightface (COMBO)：InsightFace 用于人脸分析和 embedding 提取的执行设备。选项包括 CPU、CUDA 和 ROCM。选择 CUDA 或 ROCM 可获得 GPU 加速，如果没有兼容的 GPU，则选择 CPU。
• image (IMAGE)：包含待迁移身份人脸的参考图像。使用 InsightFace 检测并编码该人脸。
• method (COMBO)：适配器的注入模式。选项：
  • fidelity：优先实现强烈的身份保持。
  • style：优先考虑已生成输出的风格。
  • neutral：在保真度与风格之间采用均衡的中间方案。
• weight (FLOAT)：PuLID 影响的整体强度。默认值为 1。范围为 -1 到 5，可按 0.05 的步长调整。高于 1 的值会强化身份特征；等于或低于 0 的值会减弱或反转适配器的效果。
• start_at (FLOAT)：适配器开始施加影响的时间步比例。默认值为 0（采样开始时）。
• end_at (FLOAT)：适配器停止施加影响的时间步比例。默认值为 1（采样结束时）。
• attn_mask (MASK，可选)：用于限制 PuLID 适配器影响已生成图像区域的注意力遮罩。适用于仅在 Latent 空间的特定区域应用身份特征。

输出

• model (MODEL)：应用 PuLID 适配器后得到的模型，可直接连接到采样器或其他适配器节点。

使用说明

• 该节点期望参考图像中包含清晰、正面的脸部，以获得最佳的 embedding 质量。
• 使用 start_at 和 end_at 将适配器的效果限定在采样的某一部分，这有助于在采样早期保持构图，同时在后期强化身份特征。
• attn_mask 输入是可选的。省略时，适配器将影响整个图像。
• 如果 InsightFace 无法在参考图像中检测到人脸，节点将失败或生成无效的 embedding，因此如有需要，请事先裁剪或对齐人脸。