企业官网建设流程全解析

HivisionIDPhotos 离线 AI 证件照制作工具完整指南

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

HivisionIDPhotos 是一款开源的离线 AI 证件照制作工具，基于一张上传的照片自动完成人脸检测、人像抠图与背景替换，生成标准一寸、二寸证件照和可打印的排版照，适合需要联网条件有限或不愿上传照片的普通用户。

项目概览：功能特性与技术基础

HivisionIDPhotos 将人脸检测、人像分割和尺寸裁剪整合为一条本地推理流水线，全部计算在用户机器上完成，照片不会上传到外部服务器。项目支持 Linux、Windows 和 macOS，主要基于 Python 3.10 及以上版本测试，推理依赖 ONNX 模型，纯 CPU 即可运行，部分模型支持 NVIDIA GPU 加速。核心能力如下：

• 标准证件照、高清透明 PNG 与六寸排版照一次生成，支持一寸、二寸及自定义尺寸
• 背景色可选蓝、白、红、灰等预设值或手动输入 HEX，渲染方式支持纯色与渐变
• 提供 MODNet、rmbg-1.4、birefnet-v1-lite 等多个抠图模型供切换
• 内置美颜（磨皮、亮度、对比度、锐化、饱和度）与人脸旋转对齐
• 可通过环境变量切换语言、运行模式等配置，并支持 Docker 一键部署

快速上手：安装依赖并启动本地服务

克隆仓库后依次安装两组依赖，前者用于核心推理，后者用于启动 Web 界面：

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

该脚本会拉取全部默认模型，也可以只指定单个模型名称下载。最后启动服务：

python app.py

运行成功后本地 7860 端口会生成一个 Web 页面，在浏览器中即可完成上传照片、选择规格、生成证件照的完整操作。

功能细节：尺寸规格、背景色与输出格式

界面提供尺寸列表、仅换背景、自定义尺寸三类规格选项。预设规格由 demo/assets/size_list_CN.csv 定义，修改后重启服务即可生效；背景色预设则由 demo/assets/color_list_CN.csv 维护。自定义尺寸支持按像素或毫米输入宽高，可用于满足特殊申报或考试要求。

背景渲染可选纯色、上下渐变、中心渐变三种方式，其中渐变模式适合打印场景，能减轻纯色背景与打印机的色差。点击开始制作后，页面会同时给出标准证件照、高清证件照（四通道透明 PNG）和带裁剪线的六寸排版照，下载默认按 300 DPI 处理，也可另存为 JPEG。排版照支持六寸、五寸、A4 等相纸规格，打印时可直接裁切。

部署与进阶用法：Docker 部署与 API 批量处理

需要批量处理或把证件照能力集成进现有系统时，可运行 deploy_api.py 启动 FastAPI 后端：

python deploy_api.py

服务监听 8080 端口，提供证件照制作、人像抠图、添加背景、排版照生成、加水印、调整文件大小等接口，均支持文件上传与 base64 两种入参方式，具体请求示例见 API 文档。

不想配置 Python 环境的用户可以直接使用官方 Docker 镜像，或基于 Dockerfile 自行构建：

docker pull linzeyi/hivision_idphotos docker run -d -p 7860:7860 linzeyi/hivision_idphotos

启动后访问 http://127.0.0.1:7860 即可使用 Web 界面；执行docker compose up -d则会把界面服务和 API 服务一起拉起。

注意事项与常见问题

模型权重是启动前提。app.py启动时会检查hivision/creator/weights目录，找不到任何抠图模型文件就会报错退出，因此首次使用前务必完成权重下载。

默认人脸检测使用内置的离线 MTCNN 模型，速度快但精度一般；追求更准的检测可将 RetinaFace 权重放入hivision/creator/retinaface/weights目录，或按 docs/face++_CN.md 配置 Face++ 在线检测服务。

若提示未检测到人脸，先确认原图清晰且只包含一张正脸照片，美颜强度等参数可在界面"高级参数"或 API 中按需调整，默认均为 0。

HivisionIDPhotos 适合个人应急制作证件照、打印排版照以及将证件照能力嵌入自有系统的场景，后续版本计划继续扩展换正装与更多美颜选项，可关注项目更新。

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