前言
证件照换装，依托AI图像生成、人像分割、图像融合技术，证件照换装可以在不重新拍摄的前提下，自动识别照片中的人像与原有服装，替换为符合规范的服装模板，同时保持面部特征、光线和姿态不变。让一张证件照通过换装，适配多种正式场景的着装规范。
证件照换装应用场景如下：
1.线上报名考试（公考、教资、各类资格证）
各类考试报名对证件照服装有要求，用户已有照片，可一键更换白衬衫、深色正装，快速生成符合报名要求的照片，省去重新到照相馆拍摄的麻烦。
2.求职简历证件照制作
求职者一键切换商务正装，制作简历、招聘平台头像证件照，快速多版本对比，打造正式形象，节约拍照费用。
API介绍
证件照换装包括三个API，分别为：规格查询-免费、预览-带水印-免费、下载-无水印
规格查询-免费
查询证件照规格，支持按规格编号、分类和名称关键词筛选。不传筛选条件时返回全部规格，多个条件同时传入时共同生效。
请求说明
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| productCode | String | 是 | 产品编号，固定值：id_photo_quick_clothe_v2 |
| specId | String | 否 | 规格编号，规格编号，按完整编号筛选；不传则不限制。 |
| categoryId | Integer | 否 | 分类：1 常用寸照、2 职业资格、3 公务员、4 学历/语言考试、5 回执专区、6 职业形象照；不传则不限制。 |
| keyword | String | 否 | 关键词，规格名称关键词，模糊匹配；不传则不限制。 |
返回样例
{
"code": 200, // 返回码，详见 code 返回码说明
"msg": "成功", // 结果说明
"taskNo": "202609030000000000000001", // 本次请求号
"data": {
// 返回数据
"list": [ // 规格列表；无匹配时为空数组
{
"specId": "C1", // 规格编号，用于检测及制作或快速换装
"name": "一寸", // 规格名称
"widthPx": 295, // 宽度，像素
"heightPx": 413, // 高度，像素
"widthMm": 25, // 宽度，毫米
"heightMm": 35, // 高度，毫米
"dpi": 300, // 打印分辨率
"requirement": "无要求", // 照片文件大小要求
"colors": "blue,white,red,tint,grey,gradient,dark_blue,sky_blue", // 可选背景颜色，英文逗号分隔；bgColor 只能选择其中一个值
"categoryId": 1, // 分类编号
"categoryName": "常用寸照" // 分类名称
}
],
"count": 1 // 本次筛选后的规格数量
}
}
预览-带水印-免费
上传人像照片，并按指定规格、背景颜色、服装制作证件照，返回带水印的证件照。
请求说明
| 名称 | 类型 | 必须 | 说明 | |
|---|---|---|---|---|
| productCode | String | 是 | 产品编号，固定值：id_photo_quick_clothe_v2 | |
| specId | String | 是 | 规格编号，规格Id。通过证件照规格查询 查询的 specId ，例如 C1、G2。 | |
| bgColor | String | 是 | 背景颜色，只能选择规格中 colors 中的一种颜色，例如 blue； | |
| clotheCode | String | 是 | 服装编号，区分大小写，取值及图片见 服装编号说明。 | |
| file | File | 否 | 图片文件，file、base64、url 至少传一个；图片最大 2 MB，上传时使用 multipart/form-data；同时传入时优先级为 base64 > file > url。 | |
| base64 | String | 否 | 图片Base64，file、base64、url 至少传一个；解码后的图片最大 2 MB；同时传入时优先级为 base64 > | file > url。 |
| url | String | 否 | 图片地址，file、base64、url 至少传一个；须为可访问且带图片扩展名的人像图片地址，图片最大 2 MB；同时传入时优先级为 base64 > file > url。 |
返回样例
{
"code": 200, // 返回码，详见 code 返回码说明
"msg": "成功", // 结果说明
"taskNo": "202609030000000000000001", // 本次请求号
"data": {
// 返回数据
"photoId": "example_photo_id", // 照片编号
"url": "https://example.com/d10/id-photo-v3/202609/03/xxxxx.jpeg" // 带水印图片地址，请及时下载保存；此处仅为结构示例
}
}
下载-无水印
上传人像照片，并按指定规格、背景颜色、服装制作无水印证件照。
请求说明
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| productCode | String | 是 | 产品编号，固定值：id_photo_quick_clothe_v2 |
| specId | String | 是 | 规格编号，规格Id。通过证件照规格查询 查询的 specId ，例如 C1、G2。 |
| bgColor | String | 是 | 背景颜色，只能选择规格中 colors 中的一种颜色，例如 blue； |
| clotheCode | String | 是 | 服装编号，区分大小写，取值及图片见 服装编号说明。 |
| file | File | 否 | 图片文件，file、base64、url 至少传一个；图片最大 2 MB，上传时使用 multipart/form-data；同时传入时优先级为 base64 > file > url。 |
| base64 | String | 否 | 图片Base64，file、base64、url 至少传一个；解码后的图片最大 2 MB；同时传入时优先级为 base64 > file > url。 |
| url | String | 否 | 图片地址，file、base64、url 至少传一个；须为可访问且带图片扩展名的人像图片地址，图片最大 2 MB；同时传入时优先级为 base64 > file > url。 |
返回样例
{
"code": 200, // 返回码，详见 code 返回码说明
"msg": "成功", // 结果说明
"taskNo": "202609030000000000000001", // 本次请求号
"data": {
// 返回数据
"photoId": "example_photo_id", // 照片编号
"url": "https://example.com/d10/id-photo-v3/202609/03/xxxxx.jpeg" // 处理后的图片地址，请及时下载保存；此处仅为结构示例
}
}
