HivisionIDPhotos 开源 AI 证件照工具功能解析与部署指南

git clone https://github.com/Zeyi-Lin/HivisionIDPhotos.git
cd HivisionIDPhotos
conda create -n hivision python=3.10
conda activate hivision
pip install -r requirements.txt -r requirements-app.txt

2. Docker 一键部署

无需配置依赖，一条命令即可启动服务：

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

3. 开发者/企业：API 集成与批量处理

通过 FastAPI 提供的接口，可快速集成到现有系统。例如企业 HR 批量处理员工照片：

import requests
import base64

def process_employee_photos(api_url, image_data, background_color=(255, 255, 255)):
    # 调用 API 生成证件照
    idphoto_response = requests.post(
        f"{api_url}/idphoto", files={"file": image_data}, data={"size": "(413,295)"} # 一寸照片规格
    )
    if idphoto_response.status_code == 200:
        # 添加白色背景
        add_bg_response = requests.post(
            f"{api_url}/add_background", files={"file": idphoto_response.content}, data={"color": str(background_color)}
        )
        return add_bg_response.content
    return None

四、对比同类工具

在证件照工具赛道，HivisionIDPhotos 的开源属性和离线能力形成了独特竞争力。

五、总结

HivisionIDPhotos 击中了用户对'高效、隐私、免费'证件照工具的核心需求。轻量的模型让老旧设备也能流畅运行，模块化设计让开发者能自由发挥，纯离线运行守住了隐私底线。

目前项目仍在高频迭代，智能换装、高级美颜等功能已列入开发计划，社区贡献也日益活跃，从 C++ 版本到微信小程序，不断丰富着应用场景。对于普通用户，它是应急必备的证件照神器；对于开发者，它是入门 AI 图像处理、二次开发的优质范本。

可通过官方仓库获取源码：https://github.com/Zeyi-Lin/HivisionIDPhotos