FaceFusion 3.2.0 参数配置参考

🧩 PROCESSORS（处理器模块）

这是换脸流程中不同阶段的处理器，可单独开启或组合使用：

模块名称	功能说明
`face_swapper`	核心换脸功能，基于模型如 `inswapper_128` 实现人脸替换。
`frame_enhancer`	视频帧整体清晰度增强（超分辨率）。
`face_enhancer`	面部区域细节增强（如眼睛、皮肤）。
`expression_restorer`	表情还原模块，修复换脸后面部表情呆滞的问题。
`age_modifier`	改变人物年龄感（年轻化或老化）。
`deep_swapper`	替代型深度换脸模型（非默认开启）。
`face_debugger`	显示人脸关键点检测结果，用于调试。
`face_editor`	编辑面部特征，如眼睛大小、嘴巴形状等（如果支持）。
`frame_colorizer`	给黑白视频或图像上色。
`lip_syncer`	嘴型同步，用于语音驱动的视频换脸（如 Talking Head）。

🧠 关键模块参数说明

🎭 Expression Restorer

MODEL: live_portrait
- 表情还原模型（如 Live Portrait）
FACTOR: 80
- 强度系数（0~100），数值越高表情越丰富，但也更容易失真。

💎 Face Enhancer

MODEL: gfpgan_1.4
- 使用 GFPGAN v1.4 模型增强面部细节（如眼睛、皮肤质感等）。
BLEND: 80
- 与原图混合程度（0~100），越高增强越明显。

🔄 Face Swapper

MODEL: inswapper_128
- 最常用且效果较稳的换脸模型，推荐用于人脸对齐良好的素材。
PIXEL BOOST: 512x512
- 增强输入图像到该尺寸进行处理，数值越高越清晰，但显存占用越大。

🖼 Frame Enhancer

MODEL: span_kendata_x4
- 超分辨率模型（如 kendata、Real-ESRGAN 等），提升图像清晰度。
BLEND: 80
- 同样是增强混合强度。

⚙️ 执行配置（性能控制）

EXECUTION PROVIDERS: cuda, tensorrt, cpu
- 优先使用的计算后端，推荐顺序：tensorrt > cuda > cpu（如支持）。
THREAD COUNT: 16
- 多线程并行处理数，一般设置为 CPU 核心数。
QUEUE COUNT: 1
- 任务队列数量，通常保持 1 即可。

🛠 下载与输出设置

DOWNLOAD PROVIDERS: github, huggingface
- 默认下载模型时使用的源地址。
VIDEO MEMORY STRATEGY: tolerant
- 显存容错策略，tolerant 表示出现爆显存时自动降配。
SYSTEM MEMORY LIMIT: 0
- 占用内存上限（MB），0 表示不限制。
OUTPUT IMAGE QUALITY: 90
- 输出图像的 JPEG 质量（1~100）。
OUTPUT IMAGE RESOLUTION: 680x1024
- 输出图像或视频帧的目标尺寸。

✅ 推荐设置建议

目标	推荐参数配置
追求高清质量	enhancer blend 设置高，输出分辨率设为 1080p 以上。
显存不足	降低 pixel boost、output resolution、blend 值。
表情自然	expression factor 设为 60~80 之间。
视频连续性强	避免过高增强强度，确保每帧风格一致。

🎯 推荐的最优参数组合（针对高质量换脸效果）

为了获得最佳的换脸效果，建议使用以下参数组合：

1	`--processors face_swapper face_enhancer expression_restorer`

此组合将执行换脸操作，并增强面部细节，同时恢复自然的面部表情。

📝 示例命令

以下是一个完整的示例命令，结合上述参数以实现高质量的换脸效果：

python facefusion.py run \
  --processors face_swapper face_enhancer expression_restorer \
  --face-swapper-model inswapper_128 \
  --face-enhancer-model gfpgan_1.4 \
  --face-mask-type region \
  --face-mask-blur 0.3 \
  --face-mask-padding 10

此命令将使用指定的模型和设置，执行换脸、增强和表情恢复操作。

另一种方案是在 facefusion.ini 配置文件中指定参数，不用每次执行命令都手动指定参数。

使用无头模式直接执行任务

1	`python facefusion.py headless-run --source-path ./facefusion/source/liuyifei.png --target-path ./facefusion/target/20250410003.jpg --output-path ./outputs/20250520004.jpg`