这是什么
HivisionIDPhotos 是一个 AI 证件照智能制作工具：一套完整的 AI 模型工作流，对各种拍摄场景的照片做识别、抠图，然后按标准规格生成证件照和六寸排版照。它的核心卖点是「轻量」——抠图完全纯离线，只要 CPU 就能快速推理，不需要显卡，也不把照片交给任何在线服务。
它能做的事包括：按不同尺寸规格生成标准证件照、六寸排版照（后来还加了五寸相纸、A4、3R、4R 几种排版尺寸）；换背景色（内置常见底色，也支持自定义 HEX 色值）；美颜；人脸旋转对齐；下载默认带 300 DPI，排版照带裁剪线方便打印裁切。路线图上还有「智能换正装」，截至本站提供的 v1.3.1 仍是开发中状态，不要当作已有功能。
它本质上是一套算法库加三种用法：本地 Gradio 图形界面（app.py，网页操作，适合个人）；Python 命令行推理（inference.py，适合批处理）；API 服务或 Docker 部署（deploy_api.py、docker-compose.yml，适合自己搭一个给家人朋友或团队共用的在线证件照服务）。不想装任何东西的话，可以在 SwanHub、HuggingFace Spaces 和 ModelScope 上的在线体验页面先试效果（地址见该工具的说明文件）。
适合谁
- 想要一个「照片不出门」的证件照方案的人：和在线换底网站不同，这套流程从抠图到排版都在你自己机器上跑，正脸照不过第三方的手；
- 手头有电脑、愿意装一次 Python 环境的人：Gradio 界面对非技术用户也算友好，装好依赖后就是打开网页点鼠标；
- 想给社区、宿舍或小团队自建证件照服务的人：API 加 Docker 的部署方式就是为这个场景准备的，一台便宜的服务器或 NAS 就能跑；
- 开发者：核心逻辑在 hivision/ 包里，Apache-2.0 许可，二改和集成都没有障碍。
不适合的情况：想零安装手机上直接出图——那用它的在线体验入口更合适；对证件照规格有极端定制需求（比如考试报名系统的奇校验像素要求）的，先用 demo 试一次再决定。
怎么用
最省事的路径是先用官方在线体验确认效果满意，再决定要不要本地化。本地部署的标准姿势：从本站「获取与校验」下载源码包解压（本站提供源码包），装好 requirements.txt 里的依赖，然后三选一——python app.py 跑 Gradio 网页版；python inference.py 走命令行推理；python deploy_api.py 或 docker compose up 起服务。首次运行会下载抠图和人脸检测的模型文件，之后推理全程离线。
界面上做一张证件照的流程：上传生活照 → 选尺寸规格和背景色 → 微调（可开启人脸旋转对齐）→ 下载单张照或排版照。排版尺寸选六寸相纸时，它会自动算一张纸能排几张并画出裁剪线，家用照片打印机直接打。
注意版本取舍：当前提供 v1.3.1，新版本经核对后更新。
安全提示
- 本站提供的是源码包，用前先用页面上的 SHA256 校验完整性（见上方「获取与校验」区块）。
- 自建部署的暴露面要管住：如果用 deploy_api.py 或 Docker 把服务开在公网，任何人都能往你的服务器传图片，建议只在内网或加鉴权后使用；不要把它当公共服务裸奔。
- 模型文件在首次运行时从网络下载，属于正常的依赖拉取；对来源较真的话，可以在有网环境先跑一次确认模型哈希，再断网使用——它的推理设计本身就支持纯离线。
- 证件照成品常与身份证件绑定，导出后文件的保管、传输和用途自己把好关；这一条与用什么工具无关。
- 换正装、AI 美颜这类功能生成的照片，用于正式证件办理时以办证机构的要求为准，别拿过度处理的照片去碰运气。
站长点评
我收录它主要是因为「纯离线 CPU 推理」这六个字：大部分 AI 证件照方案要么把你照片传云端，要么吃显卡，它两个毛病都没有，一台普通笔记本就能跑，这让它成为「自建证件照服务」这件事里最省心的底座。功能完成度也高——从抠图、换底、对齐到排版打印，链路是全的，API 和 Docker 把自建门槛压得很低。
要提醒的：它是算法库加工具，不是开箱即用的手机 App，非技术用户建议直接用官方在线体验，想清楚了再本地化；随包说明的更新节奏快但正式版本发得慢，v1.3.1 之后最新开发版已经积累了不少未发布的好东西，用固定版本就要接受功能略旧于最新开发版。另外美颜和美白属于「处理人脸」的功能，正式证件照场景里请保守使用。
版本记录
- v1.3.1（2025-01-21 发布）：当前提供 v1.3.1，新版本经核对后更新。
常见问题
为什么这个项目只提供源码包？ 本项目只提供 zip 下载——解压后的代码与该版本完全一致，日常使用和部署完全够用。
和上面 IDPhotoStudio 有什么区别？ 两者都是证件照工具但形态不同：IDPhotoStudio 是打包好的桌面应用（macOS/Windows 安装包），面向个人点鼠标使用；HivisionIDPhotos 是算法库加服务端方案（Gradio/API/Docker），面向自建和二次开发，抠图引擎和运行方式也不同。想要装完就用选前者，想自己搭服务或集成选后者。
需要显卡吗？ 不需要。官方定位就是轻量级抠图，纯 CPU 即可快速推理；Docker 和 API 服务对机器的要求也很低。
为什么这个项目只提供源码包？ 本项目只提供 zip 下载——解压后的代码与该版本完全一致，日常使用和部署完全够用。
使用时会把照片上传到哪里吗？ 本地运行（Gradio/命令行）全程在本机推理，不需要联网；只有首次运行下载模型文件需要网络。若使用官方在线体验入口或自建的公网服务，则照片自然要经过对应服务器——这是两种使用路径的本质区别，按需选择。
为什么本站版本看起来比最新版旧？ 本站提供的是 v1.3.1，新版本经核对后更新。固定版本的好处是清晰：每个版本是什么、更新日期、校验值都明明白白，拿来即用不猜版本。
来源
本页依据该工具自带的说明文件与文档整理，功能与参数以随包文档为准。