| 参数名称 | 说明 |
|---|---|
| input_image | 要执行换脸操作的目标图像。必须是合法的 IMAGE 类型张量。输入应为 3 通道 RGB 图像，通常由前置节点生成。 |
| source_image | 提供用于换脸的源图像。如果为空，需同时提供 face_model。二者必须至少提供一个。用于从该图像中提取人脸进行替换。 |
| face_model | 预提取的人脸特征模型。如果未指定 source_image，需提供该参数。 |
| options | 换脸高级配置参数，通常由 ReActorOptions 节点输出。若不提供该参数，则使用类内默认值。 |
| face_boost | 面部增强配置字典，通常由 ReActorFaceBoost 节点生成。若提供，将在换脸后执行一次或两次增强过程。 |
ReActor 🌌 Fast Face Swap [OPTIONS]
节点功能：该节点是ReActor 🌌 Fast Face Swap节点的增强版本，提供了额外的选项输入接口，允许用户通过 "ReActorOptions" 节点更精细地控制人脸替换过程。
输入参数
输出参数
| 参数名称 | 说明 |
|---|---|
| IMAGE | 换脸后的图像，格式与输入一致，已完成增强与合成。 |
| FACE_MODEL | 提取到的人脸模型，可用于后续再利用或缓存。 |
控件参数
| 参数名称 | 说明 |
|---|---|
| enabled | 是否启用该节点，关闭时会原样返回输入图像，不进行换脸处理。控件为开关。 |
| swap_model | 指定换脸所用模型，来自 model_names() 函数返回列表。 |
| facedetection | 选择人脸检测算法，提供不同精度和性能的检测器。"retinaface_resnet50" 精度高，适合静态图；YOLOv5n 性能优。换脸失败时可切换检测器尝试。 |
| face_restore_model | 用于换脸后恢复人脸质量的模型，例如 codeformer, gfpgan 等。如果想使用 CodeFormer，请确保恢复模型支持 w 参数，否则应使用默认恢复器。 |
| face_restore_visibility | 控制人脸增强图与原图的融合度，范围 [0.1, 1.0]。建议值为 0.8~1.0；越高越强调修复效果，越低越自然。 |
| codeformer_weight | 仅在使用 codeformer 模型时生效，控制修复时的重建程度。越低越真实，越高可能出现“网红脸”风格；建议保持 0.5。 |
该节点相当于将ReActor 🌌 Fast Face Swap节点拆分出来的两个组件，只是多增加了2个功能。这个只在多人换脸时用的到。关于该节点的其他参数详解可以到ReActor 🌌 Fast Face Swap节点文章中查看。