AI证件照工具实测：三步用开源HivisionIDPhotos在家搞定标准证件照

AI证件照工具实测：三步用开源HivisionIDPhotos在家搞定标准证件照

【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos

打开招聘系统上传照片，结果被提示"背景不合规"；临时要交一寸照，照相馆却已经关门。这种时刻，你需要的不是再跑一趟，而是一个能离线运行的 AI 证件照工具。HivisionIDPhotos 正是这样一个轻量级开源项目：输入一张随手拍的照片，它就能自动完成人像抠图、尺寸裁剪和底色更换，生成符合规范的标准证件照与六寸排版照，全程在你的电脑上运行。

为什么不用PS，而选一个开源证件照工具

手动处理证件照的痛点，试过的人都知道：用 Photoshop 抠头发丝要一两个小时，百度搜"在线证件照"又怕照片被平台滥用，更别提各家平台对尺寸、DPI、背景色号的要求五花八门。

HivisionIDPhotos 的价值在于把这三件事一次做完：纯离线推理，照片不出你的电脑，隐私有底；CPU 就能跑，没有显卡也能用，官方在 Mac M1 上的测试中，一次推理只需零点几秒；结果直接可交付，标准照、高清透明底 PNG、按六寸相纸自动排版的照片一次生成，支持 300DPI 输出，直接能拿去打印。

简单说，它把"照相馆的整套工序"压缩成了一条本地命令。

原理拆解：像"自动剪纸"一样的证件照流水线

看不懂代码没关系，它的工作方式可以类比成三步手工活：

1. 人像抠图——相当于自动剪纸。项目内置多种抠图模型（如 MODNet、hivision_modnet、rmbg-1.4、birefnet-v1-lite），它们把人物轮廓从背景中"剪"出来，连发丝边缘都处理得比较干净，输出一张四通道透明 PNG。你只需要在模型之间换着试，看哪个抠得更精细。
2. 人脸检测与对齐——相当于量尺寸。先定位人脸位置和角度，如果照片拍歪了，还能启用--face_align做旋转矫正，保证最终裁切时人像居中、大小比例符合证件照规格。
3. 换底与排版——相当于贴背景、排照片。根据你指定的颜色（支持 HEX 色号）和渲染模式（纯色、上下渐变、中心渐变）合成底色，再把证件照按六寸、五寸、A4 等相纸尺寸自动排列，生成可打印的排版照。

整个流程被封装在hivision目录的模型工作流里，普通用户只需要面对一个简洁的 Web 界面。

从零跑通：十分钟上手你的第一个证件照

环境要求不高：Python 3.7 以上（官方主要测试于 3.10），Windows、Linux、macOS 都行。第一次上手只需要四步：

git clone https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos cd HivisionIDPhotos pip install -r requirements.txt && pip install -r requirements-app.txt python scripts/download_model.py --models all

下载脚本会把抠图模型权重放到hivision/creator/weights目录，这一步是必需的前置条件。之后运行：

python app.py

浏览器会自动打开一个 Gradio 本地页面，上传照片、选择尺寸和底色、点击"开始制作"，右侧立刻就能看到标准照与排版照的预览。

实战演示：三个最常用的证件照玩法

玩法一：一张照片直接出标准证件照

这是最核心的用法，输入一张生活照，输出一张标准证件照和一张高清透明底 PNG：

python inference.py -i demo/images/test0.jpg -o ./idphoto.png --height 413 --width 295

默认尺寸就是一寸（413×295），--height和--width可以按需调整。生成的idphoto.png是标准照，同目录还会多出一张idphoto_hd.png高清版。

玩法二：人像抠图与证件照换底色

想单独把人物抠出来？或者拿到透明底之后想换个蓝底？

python inference.py -t human_matting -i demo/images/test0.jpg -o ./idphoto_matting.png --matting_model hivision_modnet python inference.py -t add_background -i ./idphoto.png -o ./idphoto_ab.jpg -c 4f83ce -k 30 -r 1

第二条命令里的-c是背景色 HEX 值，-r 1是上下渐变渲染，-k 30表示把输出文件控制在 30KB 左右——很多报名系统对照片大小有硬性要求，这个参数能帮你省去压缩的麻烦。

玩法三：一键生成六寸排版照

证件照要做成一版多张，直接拿去打印店输出：

python inference.py -t generate_layout_photos -i ./idphoto_ab.jpg -o ./idphoto_layout.jpg --height 413 --width 295 --k 200

它会把多张一寸照自动排列在六寸相纸上，省去了手动排版对齐的痛苦。

避坑指南：新手最容易踩的三个坑

• 提示"人脸数量不等于 1"：项目默认要求照片里只有一张人脸。合影、侧面照、遮挡严重的照片都可能触发FaceError，换一张正脸、光线均匀的照片即可。
• 忘了下载模型权重：直接跑app.py会报模型加载失败。务必先执行scripts/download_model.py --models all，或手动把权重文件放进hivision/creator/weights目录。
• 尺寸对不上报名系统：各家系统要求的尺寸五花八门，除了改--height/--width，还可以直接编辑demo/assets/size_list_CN.csv（第一列尺寸名、第二列高、第三列宽）来增删预设项，重启后就能在下拉框里选到。

延伸与收尾

这个项目已经衍生出一个不小的生态：有基于它的 ComfyUI 证件照处理工作流、微信小程序版、uniapp 多端版、网页版，甚至还有 C++ 重写版和 Windows 桌面客户端；如果你在群晖 NAS 上跑，社区也有现成的部署教程。想把它变成在线服务，运行python deploy_api.py就能启动 API 后端，方便接入你自己的应用。

下次急着交证件照，与其到处找照相馆，不如先让这个 AI 证件照工具在自己电脑上跑一遍。开源项目最好的反馈方式，就是去仓库点一个 star——这既是对开发者的认可，也是让更多被证件照困扰的人找到它的方式。

官方文档：docs/api_CN.md｜API 部署说明：deploy_api.py

【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos