分享一个免费的个人证件生成工具，不需要再找人专门进行拍摄了，随便一张自拍照就能帮你生成所需格式的证件照。
今天给大家推荐的这个开源项目是一个轻量级的 AI 证件照制作的开源项目。
不需要再找人专门进行拍摄了，随便一张自拍照就能帮你生成所需格式的证件照。
它开源了一个 HivisionIDPhoto ， 旨在开发一种实用、系统性的证件照智能制作算法。它利用一套完善的 AI 模型工作流程，实现对多种用户拍照场景的识别、抠图与证件照生成。
HivisionIDPhoto 可以做到：
- 轻量级抠图（纯离线，仅需 CPU 即可快速推理）
- 根据不同尺寸规格生成不同的标准证件照、六寸排版照
- 支持 纯离线 或 端云 推理
- 美颜（waiting）
- 智能换正装（waiting）
Demo 地址：https://swanhub.co/ZeYiLin/HivisionIDPhotos/demo
开源项目地址：https://github.com/Zeyi-Lin/HivisionIDPhotos
开源作者：Ze-Yi LIN
方式一：拉取最新镜像：
docker pull linzeyi/hivision_idphotos
2. 运行服务
启动 Gradio Demo 服务
运行下面的命令，在你的本地访问 http://127.0.0.1:7860 即可使用。
docker run -d -p 7860:7860 linzeyi/hivision_idphotos
启动 API 后端服务
docker run -d -p 8080:8080 linzeyi/hivision_idphotos python3 deploy_api.py
两个服务同时启动
docker compose up -d
环境变量
本项目提供了一些额外的配置项，使用环境变量进行设置：
环境变量 类型 描述 示例
FACE_PLUS_API_KEY 可选 这是你在 Face++ 控制台申请的 API 密钥 7-fZStDJ····
FACE_PLUS_API_SECRET 可选 Face++ API密钥对应的Secret VTee824E····
RUN_MODE 可选 运行模式，可选值为beast(野兽模式)。野兽模式下人脸检测和抠图模型将不释放内存，从而获得更快的二次推理速度。建议内存16GB以上尝试。 beast
DEFAULT_LANG 可选 Gradio Demo启动时的默认语言 en
docker使用环境变量示例：
docker run -d -p 7860:7860 \
-e FACE_PLUS_API_KEY=7-fZStDJ···· \
-e FACE_PLUS_API_SECRET=VTee824E···· \
-e RUN_MODE=beast \
-e DEFAULT_LANG=en \
linzeyi/hivision_idphotos
FAQ
1. 如何修改预设尺寸和颜色？
尺寸：修改size_list_CN.csv后再次运行 app.py 即可，其中第一列为尺寸名，第二列为高度，第三列为宽度。
颜色：修改color_list_CN.csv后再次运行 app.py 即可，其中第一列为颜色名，第二列为Hex值。
2. 如何修改水印字体？
将字体文件放到hivision/plugin/font文件夹下
修改hivision/plugin/watermark.py的font_file参数值为字体文件名
3. 如何添加社交媒体模板照？
将模板图片放到hivision/plugin/template/assets文件夹下。模板图片是一个4通道的透明png。
在hivision/plugin/template/assets/template_config.json文件中添加最新的模板信息，其中width为模板图宽度(px)，height为模板图高度(px)，anchor_points为模板中透明区域的四个角的坐标(px)；rotation为透明区域相对于垂直方向的旋转角度，>0为逆时针，<0为顺时针。
在demo/processor.py的_generate_image_template函数中的TEMPLATE_NAME_LIST变量添加最新的模板名
4. 如何修改Gradio Demo的顶部导航栏？
修改demo/assets/title.md
