企业官网建设流程全解析

HivisionIDPhotos：3 条命令从自拍到打印版，AI 证件照智能抠图完全离线

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

去照相馆排 10 分钟队、修图再等 30 分钟？HivisionIDPhotos 是一个免费开源的 AI 证件照工具：传一张自拍进去，它就能智能抠出人像、换掉底色，一键产出标准证件照和六寸排版照。全程离线运行，照片不出你的电脑。

它到底能帮你做什么

• 证件照换底色：入职要蓝底、护照要红底、签证要白底，选个颜色就行，不用打开修图软件。
• 人像抠图：自拍背景太乱？一键把人从背景里分离出来，得到一张没背景的透明 PNG，发丝都还在。
• 打印排版：做好后直接拼成六寸排版照，存到手机带去打印店冲印，不用自己排版。

一张自拍进去，一整套证件照出来，效果如下图：

五分钟跑起来

系统要求不高：Python 3.7 以上，Windows、macOS、Linux 都能跑；抠图靠纯 CPU 就能完成，不挑显卡，这也是离线证件照生成能普及的原因。

装环境

先把项目克隆下来，再装两套依赖（推理用一套、网页界面对一套），这一步是告诉电脑"工具放在哪"：

git clone https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos cd HivisionIDPhotos pip install -r requirements.txt pip install -r requirements-app.txt

跑完你会看到终端刷出一长串安装包，最后没有报错就成功了。

下模型

抠图模型的权重文件不随项目附带，要单独拉下来放进hivision/creator/weights目录，一条脚本搞定：

python scripts/download_model.py --models all

终端会出现下载进度条，结束后提示 Download completed，说明模型就位了。

启动 Demo

项目自带可视化界面（Gradio，一个几行代码就能生成网页界面的库），一条命令启动：

python app.py

跑完你会看到浏览器自动打开一个本地页面：左栏上传照片，右栏直接显示标准照、高清照和六寸排版照：

跟着走一遍：从一张自拍到打印版

这一节用仓库里的示例自拍当输入，4 条命令走完全离线的证件照主线。

1. 做出标准证件照—— 传入自拍，自动检测人脸位置并裁成标准尺寸。

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

跑完会生成./idphoto.png（一寸标准照）和./idphoto_hd.png（高清透明版）；--height和--width控制输出的像素尺寸，413x295 就是一寸规格。

2. 抠出人像—— 想要没背景的生图（比如做头像、做海报），就跑这条人像抠图命令。

python inference.py -t human_matting -i demo/images/test1.jpg -o ./idphoto_matting.png --matting_model hivision_modnet

跑完得到一张透明底 PNG，人像被完整分离出来，发丝边缘也比较干净；--matting_model控制用哪个抠图模型，hivision_modnet 对纯色换底更友好。

3. 加上底色—— 上一步的输出是没有背景的，这条命令把你要的底色"画"上去。

python inference.py -t add_background -i ./idphoto.png -o ./idphoto_ab.jpg -c 4f83ce -k 30 -r 1

跑完得到一张带蓝底的照片；-c是底色，填 6 位 HEX 颜色值（4f83ce 就是经典蓝），-r是合成模式（0 纯色、1 上下渐变、2 中心渐变），-k是输出文件的 KB 目标值。

4. 输出排版照—— 把成品照拼成六寸排版，直接可以送去打印。

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

跑完得到一张六寸排版照./idphoto_layout.jpg，单张一寸照被整齐排进六寸相纸，拿去打印就行。

调参与避坑

• 如果报"人脸数量不等于 1"：大概率是图里不止一张脸，或脸太侧没检测到。换一张单人、正面、光线足的照片重跑；脸有点歪可以加--face_align让它自动矫正。
• 如果不知道底色参数-c怎么填：这张色表里有蓝 628bce、红 d74532、白 ffffff 等常用色，直接抄 HEX 值。换完颜色不对，多半是少打了一位数字。
• 如果提示找不到模型：大概率是权重没下或者放错目录。抠图模型要放在hivision/creator/weights（RetinaFace 则放在hivision/creator/retinaface/weights），手动下载的确认文件名一致再重跑。

周边生态

• HivisionIDPhotos-ComfyUI：ComfyUI 里的证件照工作流，拖好节点就能跑。
• HivisionIDPhotos-wechat-weapp：微信小程序版，扫码就能用。
• HivisionIDPhotos-web：网页版，浏览器里直接用。
• HivisionIDPhotos-cpp：C++ 版本，适合想集进自己程序的人。

想看全部参数与调用示例，翻一翻API 文档；跑通后把自拍换成你自己的，再从头把这 4 条命令走一遍。

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