证件照智能制作开源工具AI抠图换底:HivisionIDPhotos
是一套系统性的证件照智能制作算法,依托AI模型工作流完成抠图与证件照生成。它支持纯离线或端云推理,仅用CPU即可轻量级抠图,可按规格生成证件照与六寸排版照,还提供美颜能力。
温馨提示:本文发布于 2026-11-19,内容可能随时间推移而失效;若遇到链接打不开、资源异常等情况,可在下方「反馈」中告诉我们,我们会尽快核实处理。
证件照这件事看着小,真到要用的时候却常常卡住人:尺寸规格记不住,背景颜色要对着要求一项项核,手边没有合适的拍摄条件,跑一趟照相馆又觉得为了一张图折腾半天。对独立枫叶和需要批量处理素材的人来说,这类需求出现得更频繁——填满一个表单、提交一份报名材料、给团队成员统一换上规范底色的证件照,每一次都要重复同样的裁剪和换底动作。HivisionIDPhotos 把这一连串步骤收进了一条自动化的流水线里:从识别拍照场景,到抠出人像、替换底色,再到按规格排版输出,它试图用一套模型工作流把做一张合规证件照变成一次点击。这篇稿子不谈玄乎的概念,只按项目公开的信息,把它能做什么、适合谁来用、怎么上手讲清楚,顺便把它在离线与云端之间的取舍摆出来,供你判断值不值得收进自己的工具清单。
HivisionIDPhotos是什么?
HivisionIDPhotos是一个面向证件照制作的开源智能算法项目,主要用来把普通人随手拍下的人像照片,经过识别、抠图与换底,自动处理成符合尺寸与底色要求的标准证件照,服务于需要快速、批量或应急制作证件照的人。项目由 Zeyi-Lin 发起,定位是开发一套实用、系统性的证件照智能制作算法,它并不把能力局限在单一功能上,而是用一套完善的 AI 模型工作流,串起从拍照场景识别到证件照生成的完整链路。换句话讲,它想解决的不是抠干净背景这一个点,而是证件照从原始照片到可用成品之间的整段距离:既要能判断拍摄场景,又要能轻量抠图、按规格换底,还要能输出排版照。由于支持纯离线推理,它对隐私敏感或不方便联网的场景也留了余地,这也是它在同类工具里比较特别的一点。

核心功能
- 轻量级人像抠图——纯离线即可运行,仅需 CPU 就能快速完成推理,不依赖显卡也能把人像从原图中分离出来。
- 多规格证件照生成——按不同尺寸规格输出标准证件照,同时支持六寸、五寸、A4、3R、4R 等多种打印排版照。
- 离线与端云双推理——既可以全程在本地跑,也支持端云结合,按需在隐私与算力之间做取舍。
- 自定义尺寸与底色——尺寸在 sizelistCN.csv 里增删,底色在 colorlistCN.csv 里按 HEX 值调整,改完重新运行即可生效。
- 人脸检测与旋转对齐——自动识别人脸位置并对倾斜照片做旋转对齐,自定义尺寸还支持毫米单位输入。
- 美颜与换正装——提供美颜参数与接口选项,换正装能力仍在开发中,为后续人像优化留出空间。
使用场景
| 人群/角色 | 场景描述 | 推荐指数 |
|---|---|---|
| 求职与应届生 | 网申、报名表要交不同底色的证件照,手边没有照相馆,用离线抠图快速换底并导出。 | ★★★★★ |
| 独立枫叶 | 把证件照能力接进自己的应用,通过 API 服务部署,按需调用人像抠图与换底。 | ★★★★☆ |
| 批量处理人员 | 为团队或班级统一生成同规格证件照,配合排版照与裁剪线一次导出多份。 | ★★★★☆ |
| 隐私敏感用户 | 不希望人脸照片上传云端,选择纯离线推理,在本地完成从抠图到生成的全过程。 | ★★★★☆ |
| 排版打印需求 | 要把证件照排成六寸、五寸或 A4 相纸再打印,直接用内置打印排版选项卡输出。 | ★★★☆☆ |
操作指南
- 准备环境与获取代码。项目要求 Python 3.7 及以上,主要在 Python 3.10 上测试,操作系统覆盖 Linux、Windows 与 MacOS。先通过 HivisionIDPhotos 打开项目主页,按说明克隆仓库并安装依赖;如果只是想先看看效果,也可以点击页面上的 立即使用 进入在线体验,再决定要不要在本地部署。
- 下载模型权重。人像抠图依赖模型权重文件,需要按文档把权重下载到指定位置;人脸检测模型属于可选项,按需配置即可。想进一步提速,还可以开启 GPU 推理加速,这同样是可选项。
- 启动 Gradio Demo。依赖与权重就位后,运行 app.py 启动可视化界面,就能在浏览器里体验证件照制作、人像抠图、给透明图增加底色、生成六寸排版照与证件照裁剪等能力。
- 用 Python 脚本推理。命令行方式支持用 -i 指定输入图像路径、-o 指定保存图像路径、-t 选择推理类型(idphoto、humanmatting、addbackground、generatelayoutphotos 四选一),并可用 –mattingmodel 与 –facedetectmodel 指定具体模型。
- 部署 API 服务。先启动后端,再按接口说明请求 API 服务;接口已支持美颜参数、base64 图像传入、dpi 与 face alignment 参数,方便接入自己的业务系统。
- 用 Docker 部署。依次完成拉取或构建镜像、运行服务两步,并按需要设置环境变量,适合不想折腾本地 Python 环境的场景。
- 按需求做个性化调整。尺寸改 sizelistCN.csv(第一列尺寸名、第二列高度、第三列宽度),颜色改 colorlistCN.csv(第一列颜色名、第二列 HEX 值),改完重新运行 app.py 生效;水印字体、社交媒体模板照与顶部导航栏也都有对应的修改入口。
支持平台
从项目公开信息看,HivisionIDPhotos 的落地点比较分散,覆盖了多种形态。Web 端有 Gradio Demo 与多个在线体验入口;命令行方面提供 Python 推理脚本,操作系统层面明确支持 Linux、Windows 与 MacOS,Python 要求 3.7 及以上且主要在 3.10 上测试。客户端方向,社区贡献了 Windows 客户端应用 HivisionIDPhotos-windows-GUI;扩展形态还有 ComfyUI 相关的社区项目、C++ 版本 HivisionIDPhotos-cpp,以及面向群晖 NAS 的部署教程。服务端则可以通过 API 服务或 Docker 容器来跑。需要说明的是,小程序一类形态站方没有明确列出,这里只按文档里看得到的端如实归类。
产品定价
站方未公开价格信息,以站内为准。项目以开源形式发布,公开的说明与文档中没有出现付费、订阅或授权费一类的表述,更多是邀请使用者 star 仓库、推荐给朋友。因此这里不对费用做推测,若后续涉及云端服务或第三方平台的计费,请以对应页面的实际说明为准。
常见问题
Q:如何修改预设尺寸和颜色?
尺寸和颜色都用表格文件维护,改起来不复杂。尺寸修改 sizelistCN.csv 后再次运行 app.py 即可,其中第一列为尺寸名,第二列为高度,第三列为宽度;颜色修改 colorlistCN.csv 后同样重新运行 app.py,第一列为颜色名,第二列为 Hex 值。
Q:命令行推理支持哪些类型?
通过 -t 参数指定推理类型,可选值有 idphoto、humanmatting、addbackground、generatelayoutphotos 四种,分别对应证件照制作、人像抠图、给透明图增加底色以及生成排版照;输入与输出路径分别用 -i 和 -o 指定,模型还可用 –mattingmodel 与 –facedetectmodel 选择。
Q:能直接生成适合打印的排版照吗?
可以。Gradio Demo 在 2024 年 11 月增加了打印排版选项卡,支持六寸、五寸、A4、3R、4R 五种排版尺寸,并配有排版照裁剪线功能;此前也已支持五寸相纸与 JPEG 下载选项,默认照片下载支持 300DPI。
枫叶小结
把 HivisionIDPhotos 放进工具清单前,值得先想清楚它的边界。它的强项在于把证件照从抠图到排版串成一条自动化流水线,而且支持纯离线、仅需 CPU 推理,这对隐私敏感或算力有限的使用者很实在;但它并不是万能的,智能换正装能力官方标注仍在 waiting,部分高级体验依赖模型权重下载与环境配置,上手需要一点命令行基础。它更适合接受自己搭环境、需要批量或定制化证件照的枫叶与重度用户,而只想偶尔换张背景、不愿折腾部署的人,直接用在线体验入口会更省事。综合来看,把它当成一个可二次开发的证件照底座,比当成一个开箱即用的消费级应用更贴近它的实际定位。

