
HivisionIDPhotos3 分钟出专业证件照的轻量级 AI 方案【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotosHivisionIDPhotos 是一个完全本地运行的开源 AI 证件照工具丢进一张生活照它输出带 300 DPI 的红蓝底证件照、透明底高清 PNG还能排成六寸相纸。抠图、人脸检测、美颜、排版全部离线完成不需要 GPU也不需要把照片上传到任何第三方服务。上面这张图就是它一次运行能覆盖的产出不同底色、不同规格都来自同一张照片。一张生活照是怎么变成证件照的核心流程写在 hivision/creator/init.py是四步串联抠图 → 美颜 → 人脸检测 → 构图调整。每一步都可以单独替换或跳过这也是它能做成模块化架构的原因。第一步把人从背景里抠出来。实现见 human_matting.py底层跑的是 ONNX 格式的语义分割模型——可以理解为一张预先训练好的人形蒙版生成器。仓库内置 5 个权重从 24.7MB 的 MODNet 到 224MB 的高精度 BiRefNet 都有精度和速度自己权衡。第二步定位人脸并摆正。face_detector.py 提供三种方案默认用 MTCNN纯离线、毫秒级出结果复杂场景可以换 RetinaFace 离线权重或者接 Face 的在线 API。开启人脸对齐后检测到头倾斜超过 2°系统会自动旋转矫正原图和透明抠图层。第三步按标准裁切构图。很多人以为证件照随便截一块就行实际上脸的位置、大小、头顶留空都有讲究。photo_adjuster.py 里用三个比例参数控制人脸中心在全图高度 45% 处、人脸面积约占全图 20%、头顶留 10%~12%。参数不满意的场景——比如签证照的官方比例——都可以在调用时改不用动代码。第四步输出成品。每次会同时给你两张一张标准尺寸照默认 295×413一寸一张按比例放大的高清照都是带透明通道的 PNG方便后续换底色。背景合成支持纯色、上下渐变、中心渐变三种模式。CPU 环境下的最快跑通路径这是 Mac M1 Max 纯 CPU无 GPU 加速下的实测数据输入分辨率为 512×715 和 764×1146 两张测试图模型组合内存占用512×715 耗时764×1146 耗时MODNet MTCNN410MB0.207s0.246sMODNet RetinaFace405MB0.571s0.971sBiRefNet-lite RetinaFace6.20GB7.063s7.128s对 CPU 机器第一行就是甜点位半秒出图内存不到 500MB。追求发丝级抠图精度就上第三行代价是时间拉长到 7 秒左右、内存吃满 6GB——有 16GB 显存的 NVIDIA 卡可以装 onnxruntime-gpu 加速 BiRefNet。从克隆到出图三种跑通方式方式一Web 界面体验最快。克隆后装依赖、下模型然后一行启动浏览器打开http://127.0.0.1:7860选尺寸底色点生成即可界面支持中、英、日、韩四种语言git clone https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos cd HivisionIDPhotos pip install -r requirements.txt -r requirements-app.txt python scripts/download_model.py --models all python app.py方式二Python 库调用写进自己的程序。整个流程就是一次函数调用参数包括底色尺寸、美颜强度、是否人脸矫正from hivision import IDCreator from PIL import Image creator IDCreator() result creator(Image.open(demo.jpg), size(413, 295)) Image.fromarray(result.standard).save(idphoto.png)方式三命令行批量处理。inference.py 支持 5 种任务直接出证件照、单独抠图、给透明图换底色、生成六寸排版照、裁切透明图。处理一整批员工照片时写个循环调它就行输出默认 300 DPI满足冲印要求。容器部署和 API 服务要把它挂到内网或自己的网站上用 Docker 最省事。镜像自带完整环境一条命令起 Web 界面换条命令起 API 后端默认 8080 端口文档在 docs/api_CN.mddocker run -d -p 7860:7860 linzeyi/hivision_idphotosdocker run -d -p 8080:8080 linzeyi/hivision_idphotos python3 deploy_api.pyAPI 返回的是 base64 透明图前端切底色时不用反复请求后端这个设计对做在线证件照产品的人比较友好。尺寸颜色、模板照与二次开发预设尺寸和底色两个 CSV 说了算——size_list_CN.csv 加一行就是新规格color_list_CN.csv 加一行就是新底色改完重启app.py生效。社交模板照往 hivision/plugin/template/assets/ 丢一张透明底 PNG在 template_config.json 里登记透明区四个角坐标你的照片就会自动嵌进模板里做出下面这种社媒分享图。美颜强度美白、亮度、对比度、锐化、饱和度五个参数独立可调默认全是 0也就是不动原图。社区衍生README 收录了 C 版、ComfyUI 工作流、微信小程序原生 uniapp 两个、Windows 桌面客户端、群晖 NAS 部署教程想往哪个方向接都有现成参考。谁适合用它需要本地离线出证件照的个人、想集成证件照能力的开发者、做冲印或 HR 批量场景的团队都可以直接用Apache-2.0 协议商用没有额外成本。现在去克隆仓库装依赖、下模型半秒后就能看到第一张 300 DPI 的证件照。【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考