# 不止证件照：HivisionIDPhotos Pro 的功能、部署与 API 接入


本文介绍一个基于 HivisionIDPhotos 二次开发的开源项目——**HivisionIDPhotos Pro**。它保留了证件照基础流程，扩展了更多图片处理能力，并通过独立 API 提供服务，适合用来搭建证件照应用或图片工具箱。

证件照制作看起来只是抠图换底，真正做成一个应用，还需要尺寸裁切、换装、文件压缩和打印排版。如果要接入网站或小程序，开发者还得考虑这些功能怎么调用、怎么组合。

![1.jpg](https://developer.qcloudimg.com/http-save/yehe-3422325/dfd17a5c867b5a349d4f8c8cabeb1079.jpg)
## 一、有哪些功能？

Pro 的功能可以分成三类，不必先研究模型和参数，也能了解它适合做什么：

- **证件照制作**：人像抠图、尺寸裁切、标准照或高清照生成、纯色和渐变换底、美颜调整、男装/女装/儿童装换装，以及相纸排版
- **照片风格与修复**：美式证件照、社交模板照、情侣红底照、动漫风照片、黑白照片上色和清晰度增强
- **通用图片处理**：人像与主体抠图、文字水印、KB 压缩、格式转换，以及返回分类分数的图片检测

各项能力可以单独使用，也可以串成完整流程。例如，先生成透明证件照，再添加底色，最后生成排版照；需要换装时，换装接口本身就能合成背景。

相比只提供一个操作页面，这种拆分也方便业务端按自己的产品设计组织功能。

## 二、快速部署与体验

想先看界面，可以直接打开[在线体验页面](https://hivisionidphotospro.0po.cn/demo/index.html)。准备自行部署时，按当前 README 使用 **Python 3.10.4** 环境，先获取代码并安装依赖：

```bash
git clone https://github.com/no1yu/HivisionIDPhotosPro.git
cd HivisionIDPhotosPro
python3 -m pip install -r requirements.txt
```

然后按照 README 下载需要的模型文件，放入 `creator/models/` 下对应目录。后面的证件照示例采用默认配置，需要准备 `ppMattingV2` 和 `yunet` 对应权重；只用部分功能时，不必下载全部模型。

完成后，使用仓库给出的 Uvicorn 命令启动服务：

```bash
python3 -m uvicorn app:app --host 0.0.0.0 --port 8081 --workers 1 --limit-concurrency 9999 --backlog 1024
```

本机可访问 `http://127.0.0.1:8081/demo/index.html` 查看功能页面，也可以使用 `/demo/index2.html` 体验另一种界面。这里采用的是 Pro 自己的部署方式，原版教程里的 Gradio、Docker 命令不应直接套用。

![2.png](https://developer.qcloudimg.com/http-save/yehe-3422325/de609bb8aacbd36088f688bee5c70f60.png)

## 三、用一个 API 示例看接入方式

Pro 使用 `POST + multipart/form-data` 上传图片和参数。以生成标准证件照为例，服务启动并准备好所需模型后，把下面的 `person.jpg` 换成你的单人正面照片：

```bash
curl -f -X POST http://127.0.0.1:8081/idphoto \
  -F "input_image=@person.jpg" \
  -F "height=413" \
  -F "width=295" \
  -F "hd=false" \
  -o idphoto.png
```

这个请求返回的是 **295 × 413 像素的透明背景 PNG**，不是已经加好底色的成片。接下来可以把它交给 `/add_background` 添加背景，再调用 `/generate_layout_photos` 排版。`hd=false` 用来明确选择标准尺寸，方便后续处理保持尺寸一致。

图片处理接口成功时直接返回图片二进制，图片检测接口 `/checkImg` 成功时返回 JSON。按当前项目协议，HTTP `200` 表示成功，失败则返回 HTTP `404` 和 JSON 错误原因。完整接口及参数见 [API.md](https://github.com/no1yu/HivisionIDPhotosPro/blob/master/API.md)。

## 四、配套小程序与管理生态

如果目标不只是运行一个图片服务，而是开发完整的微信小程序，还可以继续参考三个配套项目：

- [photoOneV2](https://github.com/no1yu/photoOneV2)：原生微信小程序前端，负责照片制作、预览、保存等用户操作
- [HivisionIDPhotos-wechat-weappV2](https://github.com/no1yu/HivisionIDPhotos-wechat-weappV2)：Java 业务后端，负责用户、订单、支付等业务，并对接 Pro 图像服务
- [zjzAdminV2](https://github.com/no1yu/zjzAdminV2)：网页管理后台，负责配置、规格、素材和订单等管理

这几个项目分工明确：Pro 负责图片处理，小程序负责用户交互，Java 后端和网页后台负责业务与管理。开发者可以根据需要选择图像服务接入，或继续参考整套小程序实现。

![xcx1.png](https://developer.qcloudimg.com/http-save/yehe-3422325/463b45ed95889d83c0644432d4d0816e.png)
![xcx2.png](https://developer.qcloudimg.com/http-save/yehe-3422325/f4320f6313cbe47fad1a144fad3e85de.png)


对于正在开发证件照网站、小程序或图片工具箱的人来说，Pro 提供了一个具体的开源起点。可以先体验功能，再按业务需要部署和接入。照片质量会影响最终效果，正式使用前仍需按使用单位的照片要求核对。


**项目源码与部署说明：**[HivisionIDPhotos Pro](https://github.com/no1yu/HivisionIDPhotosPro)


本文介绍一个基于 HivisionIDPhotos 二次开发的开源项目——HivisionIDPhotos Pro。它保留了证件照基础流程，扩展了更多图片处理能力，并通过独立 API 提供服务，适合用来搭建证件照应用或图片工具箱。

HivisionIDPhotos的升级版HivisionIDPhotos Pro

人工智能

开发工具

后端

HivisionIDPhotosPro开源项目基于证件照制作扩展出人像抠图、换底、换装、排版、修复及通用图片处理等能力，支持独立API灵活组合调用。项目提供清晰部署流程与小程序、后端、管理后台配套方案，适合快速搭建证件照应用或图片工具箱服务。

2026上云采购 | AI焕新·智启新局

imageprocess

一键玩转AI人脸特效，新用户14.9元起


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

HivisionIDPhotos的升级版HivisionIDPhotos Pro-腾讯云开发者社区-腾讯云

HivisionIDPhotos的升级版HivisionIDPhotos Pro

HivisionIDPhotos的升级版HivisionIDPhotos Pro

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐