前言

证件照换装，依托AI图像生成、人像分割、图像融合技术，证件照换装可以在不重新拍摄的前提下，自动识别照片中的人像与原有服装，替换为符合规范的服装模板，同时保持面部特征、光线和姿态不变。让一张证件照通过换装，适配多种正式场景的着装规范。

证件照换装应用场景如下：
1.线上报名考试（公考、教资、各类资格证）
各类考试报名对证件照服装有要求，用户已有照片，可一键更换白衬衫、深色正装，快速生成符合报名要求的照片，省去重新到照相馆拍摄的麻烦。
**2.求职简历证件照制作 **
求职者一键切换商务正装，制作简历、招聘平台头像证件照，快速多版本对比，打造正式形象，节约拍照费用。

API介绍

证件照换装包括三个API，分别为：规格查询-免费、预览-带水印-免费、下载-无水印

戳这里查看详情

规格查询-免费

查询证件照规格，支持按规格编号、分类和名称关键词筛选。不传筛选条件时返回全部规格，多个条件同时传入时共同生效。

请求说明

返回样例

{
  "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 // 本次筛选后的规格数量
  }
}

预览-带水印-免费

上传人像照片，并按指定规格、背景颜色、服装制作证件照，返回带水印的证件照。

请求说明

返回样例

{
  "code": 200, // 返回码，详见 code 返回码说明
  "msg": "成功", // 结果说明
  "taskNo": "202609030000000000000001", // 本次请求号
  "data": { // 返回数据
    "photoId": "example_photo_id", // 照片编号
    "url": "https://example.com/d10/id-photo-v3/202609/03/xxxxx.jpeg" // 带水印图片地址，请及时下载保存；此处仅为结构示例
  }
}

下载-无水印

上传人像照片，并按指定规格、背景颜色、服装制作无水印证件照。

请求说明

返回样例

{
  "code": 200, // 返回码，详见 code 返回码说明
  "msg": "成功", // 结果说明
  "taskNo": "202609030000000000000001", // 本次请求号
  "data": { // 返回数据
    "photoId": "example_photo_id", // 照片编号
    "url": "https://example.com/d10/id-photo-v3/202609/03/xxxxx.jpeg" // 处理后的图片地址，请及时下载保存；此处仅为结构示例
  }
}