Easy Apply InstantID 节点：ComfyUI 身份保持应用指南(instantIDApply)

此节点在 EasyUse pipeline 中应用 InstantID 身份保持功能。它接收人脸图像、已选择的 InstantID 模型、可选的 ControlNet，以及基于 InsightFace 的人脸分析，将身份信息注入模型，并生成适合采样的正面/负面条件。

输入

必填

• pipe (PIPE_LINE): 包含模型、条件和其他采样数据的 pipeline 状态。此节点会更新该 pipeline 并应用 InstantID 适配器。
• image (IMAGE): 用于提取 InstantID 身份 embedding 的人脸图像。
• instantid_file (COMBO): 从可用文件中选择要使用的 InstantID 模型文件。
• insightface (COMBO): 用于 InsightFace 人脸分析的设备后端。选项：CPU、CUDA、ROCM。请选择与您的可用硬件相匹配的后端。
• control_net_name (COMBO): 选择与 InstantID 搭配使用的 ControlNet 模型文件，用于结构/姿态引导。
• cn_strength (FLOAT): ControlNet 的应用强度。默认值为 1.0，范围 0.0 到 10.0。
• cn_soft_weights (FLOAT): ControlNet 贡献的软权重。默认值为 1.0，范围 0.0 到 1.0。
• weight (FLOAT): InstantID 身份适配器的整体强度。默认值为 0.8，范围 0.0 到 5.0。
• start_at (FLOAT): InstantID/ControlNet 条件开始生效时在 denoise 过程中的位置比例。默认值为 0.0，范围 0.0 到 1.0。
• end_at (FLOAT): InstantID/ControlNet 条件停止生效时在 denoise 过程中的位置比例。默认值为 1.0，范围 0.0 到 1.0。
• noise (FLOAT): 应用于条件/身份 embedding 的噪波数量。默认值为 0.35，范围 0.0 到 1.0，步长 0.05。

可选

• image_kps (IMAGE): 可选的关键点/姿态图像，用作 ControlNet 的关键点输入以提供结构引导。
• mask (MASK): 可选的遮罩，用于将 InstantID 效果限制在图像的特定区域。
• control_net (CONTROL_NET): 可选预加载的 ControlNet 模型。提供后，可覆盖 control_net_name 所选择的模型。

输出

• PIPE_LINE: 已应用 InstantID 条件的更新后 pipeline 状态。
• MODEL: 已应用 InstantID 适配器和 ControlNet 的修补后模型。
• CONDITIONING: 包含 InstantID 身份信息的正面条件。
• CONDITIONING: 采样时使用的负面条件。

使用说明

• 使用返回的模型进行采样时，请使用正面和负面条件输出。
• 为确保可靠提取身份信息，image 应为清晰的人脸图像。
• 如果提供了 image_kps，则可将姿态/结构信息与身份图像分开传递。
• start_at 和 end_at 值可让您控制在 denoise 过程中 InstantID/ControlNet 引导何时生效，这对于平衡身份保真度与整体构图非常有用。
• 选择正确的 insightface 后端对性能和兼容性很重要。当 GPU 加速可用时使用 CUDA 或 ROCM，否则使用 CPU 作为回退方案。