FaceFusion 3.2.0 参数配置参考

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 之间。
视频连续性强	避免过高增强强度，确保每帧风格一致。

---

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

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

--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 配置文件中指定参数，不用每次执行命令都手动指定参数。

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

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

安装 coda 环境时可能遇到网络问题

指定清华源安装

conda install -c https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge \
    cuda-runtime=12.8.1 cudnn=9.8.0.87

参考官方文档

官方文档：https://docs.facefusion.io/

GitHub 仓库：https://github.com/facefusion/facefusion