一、项目简介
HivisionIDPhotos 是由国内开发者 Zeyi-Lin 与 SwanLab 团队开源的轻量级 AI 证件照制作工具,核心用 MODNet 模型实现离线人像抠图与证件照自动生成,CPU 即可快速推理。
- GitHub:https://github.com/Zeyi-Lin/HivisionIDPhotos
- Gitee:https://gitee.com/it2022/HivisionIDPhotos
- 在线体验:魔搭社区、Hugging Face 等。


二、核心功能
智能人像抠图
- 基于 MODNet,百万级人像数据训练,发丝/衣物边缘精准分割,误差≤2像素。
- 支持复杂背景、透明背景输出(PNG)。
多规格证件照生成
- 预设:1寸/2寸、护照、签证、身份证、驾照、美式证件照。
- 自定义:宽高/毫米/像素、300DPI 默认。
背景与美颜
- 底色:红/蓝/白/渐变/自定义 HEX 色值。
- 美颜:磨皮、美白、瘦脸、五官优化。
排版与输出
- 排版:6寸/5寸/A4/3R/4R 打印布局,带裁剪线。
- 输出:JPG/PNG,可指定 KB 大小(如 20–100KB)。
人脸校正
- 自动旋转对齐、姿态矫正,保证五官居中合规。
三、技术特点
- 轻量离线:无后端依赖,纯本地 CPU 推理,10 秒出图。
- 多模型支持:抠图(MODNet、RMBG、BiRefNet);人脸检测(MTCNN、RetinaFace)。
- 多端部署:Gradio 可视化界面、Python API、FastAPI 服务、Docker 容器。
- 跨平台:Windows/macOS/Linux,支持 CPU/GPU 推理。
四、使用方式
- 在线体验:浏览器打开魔搭社区等链接,上传照片→选规格→生成→下载。
本地部署
git clone https://github.com/Zeyi-Lin/HivisionIDPhotos.git cd HivisionIDPhotos pip install -r requirements.txt python demo/ui.py # 启动 Gradio 界面- API 调用:部署 FastAPI 服务,通过 HTTP 请求生成证件照。
五、应用场景
- 个人:求职、考试、签证、护照证件照制作。
- 开发者:二次开发集成到 App/小程序/网站。
- 企业:员工证件照批量生成、政务系统集成。
六、优势对比
- 对比在线工具:免费开源、离线可用、无隐私泄露风险。
- 对比照相馆:低成本、高效率、随时可用、效果可控。
- 对比同类开源项目:功能全、易部署、中文友好、社区活跃。
七、总结
HivisionIDPhotos 是国内领先的开源 AI 证件照方案,集抠图、换底、裁尺寸、美颜、排版于一体,离线轻量、易集成,适合个人与企业使用。