前言：本文分享AI图像修复工具IOPaint。

一、IOPaint 是什么

IOPaint 是一款开源、免费、可完全本地化部署的 AI 图像修复（inpainting）工具，核心作用是**“擦除、替换、生成”**像素：

• 擦除：水印、路人、划痕、电线杆等任何不需要的物体；
• 替换：把目标物体换成另一元素（换背景、改文字）；
• 生成：在空白区域外延补图（out-painting）或在蒙版区重绘（in-painting）。

它把最新学术模型包装成一键即用的 Web 界面，既适合设计师精修，也适合普通用户“去水印”。

二、核心功能与对应模型

三、底层技术原理（精简版）

1. 蒙版+扩散模型：用户涂色=生成 0/1 蒙版；模型在蒙版区做“降噪重建”，用周围语义信息填补。
2. 控制网络：额外条件（Canny 边缘、深度图）保证新内容与原始透视、光影一致。
3. 多语言文本生成：AnyText 额外输入“字形图+位置掩码”，让扩散过程把字符形状嵌入像素，避免粘贴感。

四、安装与启动（3 行命令）

# 1. 装包（清华源加速）
pip install iopaint -i https://pypi.tuna.tsinghua.edu.cn/simple
# 2. 启动（CPU 版示例）
iopaint start --model=lama --device=cpu --port=8080
# 3. 打开浏览器
http://localhost:8080

GPU 用户把 --device cpu 换成 --device cuda 即可提速 10-50 倍；Apple Silicon 用 --device mps。

Docker 一条命令也行：

docker run -p 8080:8080 -v /your/models:/root/.cache/huggingface \
           -v /your/output:/app/output ghcr.io/sanster/iopaint:latest

模型首次调用自动下载，离线后完全断网可用。

五、蒙版工作流（决定成败的关键）

• 自动生成：点击“Interactive Seg”→ 在图上点两下 → SAM2 生边缘精准的蒙版 → 直接擦或换。
• 手工微调：支持“膨胀/腐蚀/反向”滑块，像素级修边，避免多擦或少擦。
• 批量 API：

import requests, base64, io
mask = Image.open("mask.png")
b64  = base64.b64encode(io.BytesIO().read()).decode()
r = requests.post("http://localhost:8080/api/v1/adjust_mask",
                  json={"mask": f"data:image/png;base64,{b64}",
                        "kernel_size": 5, "operate": "expand"})

六、实战小技巧

1. 复杂背景：先“超分”再“擦除”，纹理更清晰。
2. 大合影修脸：GFPGAN 做人脸，LaMa 做身体污点，两步完成。
3. 电商白底：RemoveBG 一键去底 → Real-ESRGAN 放大 → AnyText 重新排版，全在一条网页流水线完成。
4. 性能调优：
   • 低显存加 --low-mem；
   • 批量任务用 CLI：iopaint run --input-dir ./imgs --output-dir ./out --model lama --device cuda。

七、隐私与成本

• 100% 本地运算，无上传，适合保密片、商业稿。
• 完全免费，替代 Photoshop 内容识别填充+Topaz 放大+Remove.bg 等多款付费插件。

八、常见坑与解决

最后总结

IOPaint = “开源版 PS 生成式填充 + Topaz 放大 + Remove.bg + 字幕排版”，免费、离线、跨平台，一条命令就能用，是 AI 时代的“万能橡皮擦”。

今日分享完毕。