Stable Diffusion WebUI 集成:AUTOMATIC1111 一键调用 CodeFormer
安装
方式一:WebUI 内置(推荐)
AUTOMATIC1111 从 v1.1 开始内置 CodeFormer 支持。不需要额外安装插件。
方式二:手动安装插件(旧版 WebUI)
如果你的 WebUI 版本较老:
cd extensions/
git clone <仓库地址>
# 或者从 Extensions → Available → Install 搜 CodeFormer
使用位置
WebUI 的 Extras 标签页:
- 打开 Extras 标签
- 上传要修的图(或从 txt2img 直接 Send to Extras)
- 右侧 Face restoration 下拉菜单选 CodeFormer
- 调参数:
- CodeFormer w weight (0-1):AI 生图默认 0.3
- CodeFormer upscale:通常 2
- 点 Generate
参数详解
| 参数 | 默认 | AI 生图推荐 | 说明 |
|---|---|---|---|
| w weight | 0.5 | 0.3 | 质量 vs 身份,AI 生图偏向质量 |
| upscale | 2 | 2 或 4 | 修复后的上倍倍率 |
其他参数(detection、crop ratio)沿用 WebUI 的通用 Face Restoration 设置。
在 WebUI 里的典型工作流
工作流一:txt2img → CodeFormer → 放大
txt2img(生成 1024×1024 候选)
↓ Send to Extras
Extras → Face Restoration → CodeFormer (w=0.3)
↓ 同一 Extras 页面
Upscaler → Real-ESRGAN x4plus
↓ Generate
成品(4096×4096,人脸修复 + 整图放大)
工作流二:Chain 修复(GFPGAN → CodeFormer)
AI 生图严重崩坏时:
txt2img 生图
↓ Extras → GFPGANv1.4(激进修复)
↓ Send to Extras 再来一次
Extras → CodeFormer w=0.4(精细化)
↓
最终成品
GFPGANv1.4 适合修完全崩坏的脸(多眼、严重畸变),CodeFormer 适合在 GFPGAN 修复的基础上再做精细化。
工作流三:Inpainting + CodeFormer
SD 生图中如果你只对人脸区域不满意,可以:
- img2img → Inpaint
- 用 mask 只遮人脸
- Inpainting 后 Send to Extras → CodeFormer 再修一遍
这样既保持了原图的非人脸区域,又把脸修好了。
WebUI vs 命令行
| 维度 | WebUI | 命令行 |
|---|---|---|
| 上手 | 可视化,快 | 要敲命令 |
| 批量 | 支持(Batch 面板) | 直接 --input_path 文件夹 |
| 参数 | 下拉/滑块 | --flag 方式 |
| 调试 | 每次生成都能对比 | 需存多个输出文件 |
| 和 SD 集成 | 无缝(Send to Extras) | 需先保存图再命令行跑 |
AI 生图场景 WebUI 明显更方便。老照片批量处理命令行更合适。
GPU 显存
WebUI 同时开 txt2img 和 CodeFormer 需要的显存 = SD 生图显存 + CodeFormer 推理显存:
- SD 生图(512×512):~6GB
- CodeFormer 推理:~4GB
- 合计:至少 10GB
12GB 卡够用,8GB 卡可能需要关掉 SD 的一些功能(如不用 --medvram 也能跑,但加 CodeFormer 就顶不住了)。
其他 SD WebUI 集成
除了内置 Face Restoration,还有社区插件:
- CodeFormer 单独面板:把 CodeFormer 做成一个独立的 txt2img img2img 标签(不经过 Extras)
- ControlNet + CodeFormer:人脸 ControlNet 约束 CodeFormer 修复方向
- Automatic CodeFormer:每次生成后自动修脸(需配置)