IOPaint 使用指南：免费 AI 图像修复完整教程-酒店常州论坛

IOPaint 使用指南：免费 AI 图像修复完整教程

【免费下载链接】IOPaintImage inpainting tool powered by SOTA AI Model. Remove any unwanted object, defect, people from your pictures or erase and replace(powered by stable diffusion) any thing on your pictures.项目地址: https://gitcode.com/GitHub_Trending/io/IOPaint

IOPaint 是一款免费开源的 AI 图像修复工具。它把你框选的图像区域自动"补全"，可以去除水印、文字、多余人物或老照片缺陷，还能用 Stable Diffusion 生成新内容。设计师、摄影师或只需要批量处理几张图的你，在自己电脑上跑起来就能用。

3分钟跑通第一次去水印

三步，第一次修复就能出图：

安装并启动服务：

pip3 install iopaint iopaint start --model=lama --device=cpu --port=8080

首次运行会自动下载 LaMa 模型，终端打印服务启动信息后，浏览器里就能打开页面。

浏览器打开http://localhost:8080，上传一张带水印的图。
用画笔圈出水印区域（白色蒙版即待修复范围），点击修复。你会看到水印消失、底下纹理被自然补全。

三类麻烦图，分别怎么处理

日常修图最烦的三件事，都能在网页界面直接解决，蒙版画得不用特别精确。

去掉图库水印

痛点：图库图上一整片水印，没法直接用；PS 里手动修背景费时还容易留痕迹。做法：网页中选 LaMa（默认模型），用画笔盖住水印文字后点修复；水印面积大就把笔刷放大一些。效果：LaMa 是专为快速移除设计的轻量模型，几秒钟出图，周边纹理衔接无明显接缝。

去水印前：水印铺满画面，遮挡主体

去水印后：水印消失，衣物褶皱与背景细节保留

去掉封面文字

痛点：封面图、海报被标题文字压住，你只想要底下的美术画面。做法：用细笔刷精确圈住文字区域，蒙版不必贴边，LaMa 会推断底层内容。效果：修复后文字消失，底层画面自然延续，看不出擦除痕迹。

去文字前：大字占据画面一半

去文字后：文字消失，美术画面自然延续

去掉多余人物或物体

痛点：画面里混进了不想要的物体，简单擦除会留下一块"糊"。做法：同样用画笔圈选；面积大、结构复杂时，可换成 Stable Diffusion 系模型，补全更像"真"的背景。效果：物体消失，填充区域的光影和纹理与周围一致。

去除前：画面中多出一个白色灯笼

去除后：灯笼消失，天花板纹理与周围一致

IOPaint 如何"补全"图像

你不用懂模型细节，只需知道哪个任务选哪个模型。流程很直接：你的蒙版负责圈"哪里要修"，模型负责决定"怎么补"。LaMa 这类擦除模型只做填充，快，适合移除任务；扩散类模型（Stable Diffusion、BrushNet、AnyText）能理解提示词并生成新内容，适合替换物体、写文字、向外扩图。全部模型源码见 iopaint/model/。

三个能直接上手的进阶玩法

单图修熟之后，下面三个功能会让你效率翻倍。

批量处理：图片量大时，跳过网页直接命令行。--image和--mask可传目录（蒙版文件名须与原图一致），结果写入--output：

iopaint run --model=lama --device=cpu \ --image=input_dir --mask=mask_dir --output=output_dir

跑完后，输出目录里会看到与原图等大的一组处理好的图片。

交互分割：不想手动刷蒙版，启动时加--enable-interactive-seg，在网页里点一下物体，自动选区生成蒙版。GFPGAN 人脸修复、RealESRGAN 超分、去背景同样在 iopaint/plugins/ 里各加一个开关即可启用。
换模型：--model可切换 SD/SDXL 修复模型、BrushNet、AnyText 等，例如 AnyText 专门画指定文字，PowerPaint 做向外扩图。

部署三行速查

无论本机还是服务器，各一行命令就够：

环境	启动方式	你会得到
本地	`iopaint start --model=lama --device=cpu --port=8080`	localhost:8080 的网页界面
容器	`docker build -f docker/CPUDockerfile -t iopaint .`，再`docker run -p 8080:8080 iopaint`	隔离环境；GPU 换`docker/GPUDockerfile`
API	`POST /api/v1/inpaint`，接口定义见 iopaint/api.py	可嵌入你自己程序调用

5个容易踩的坑

以下都是实际使用里最常卡住人的点，先读完能省掉不少排查时间。

首次运行慢不是卡死：模型首次会自动下载，耐心等；想换下载目录加--model-dir。
蒙版命名：批量模式下蒙版图必须与原图同名，否则找不到文件；传单张蒙版时会自动缩放尺寸复用到所有图。
GPU 不是装上就快：--device=cuda需要按 README 先装 CUDA 版 PyTorch，否则跑不起来或报错。
大图解显存不足：加--low-mem推理后释放显存，或--cpu-offload在显存有限时跑扩散模型。
别一上来就选扩散模型：简单移除用 LaMa 就够，快且轻；SD 系模型慢，CPU 上体验尤其差。

IOPaint 是能自托管的免费开源图像修复工具：框选区域，模型补全。经常要去水印、文字、多余物体，或要把图像修复接进自己流程的，适合用它；想要零安装云端服务或一键语义级换物体的，它不适合。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析