codeformer 中文文档 下载 App

Stable Diffusion WebUI 集成:AUTOMATIC1111 一键调用 CodeFormer

安装

方式一:WebUI 内置(推荐)

AUTOMATIC1111 从 v1.1 开始内置 CodeFormer 支持。不需要额外安装插件。

方式二:手动安装插件(旧版 WebUI)

如果你的 WebUI 版本较老:

cd extensions/
git clone <仓库地址>
# 或者从 Extensions → Available → Install 搜 CodeFormer

使用位置

WebUI 的 Extras 标签页:

  1. 打开 Extras 标签
  2. 上传要修的图(或从 txt2img 直接 Send to Extras)
  3. 右侧 Face restoration 下拉菜单选 CodeFormer
  4. 调参数:
  1. 点 Generate

参数详解

参数默认AI 生图推荐说明
w weight0.50.3质量 vs 身份,AI 生图偏向质量
upscale22 或 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 生图中如果你只对人脸区域不满意,可以:

  1. img2img → Inpaint
  2. 用 mask 只遮人脸
  3. Inpainting 后 Send to Extras → CodeFormer 再修一遍

这样既保持了原图的非人脸区域,又把脸修好了。

WebUI vs 命令行

维度WebUI命令行
上手可视化,快要敲命令
批量支持(Batch 面板)直接 --input_path 文件夹
参数下拉/滑块--flag 方式
调试每次生成都能对比需存多个输出文件
和 SD 集成无缝(Send to Extras)需先保存图再命令行跑

AI 生图场景 WebUI 明显更方便。老照片批量处理命令行更合适。

GPU 显存

WebUI 同时开 txt2img 和 CodeFormer 需要的显存 = SD 生图显存 + CodeFormer 推理显存:

12GB 卡够用,8GB 卡可能需要关掉 SD 的一些功能(如不用 --medvram 也能跑,但加 CodeFormer 就顶不住了)。

其他 SD WebUI 集成

除了内置 Face Restoration,还有社区插件: