使用证件照制作API的核心原因在于解决传统证件照拍摄和制作过程中的效率低、成本高、标准难统一、用户体验差等痛点。对于企业、开发者或平台运营者来说，接入API不仅仅是“做一个功能”，更是为了降本增效和提升业务转化率。
功能特性
随时随地办理：用户无需专门跑照相馆，只需在手机/电脑端上传自拍或生活照，几秒钟即可生成合规照片。这对于急需报名考试、办理签证或入职的用户极具吸引力。
即时反馈：用户可立即预览效果并调整（如更换背景色、微调美颜），满意度更高。
快速集成：成熟的API通常提供完善的SDK和文档，开发人员可在几小时甚至几十分钟内完成集成上线，极大缩短产品上市时间（Time-to-Market）。
降低流失率：在注册、报名或认证流程中，如果要求用户上传严格符合标准的照片，很多用户会因“不知道怎么拍”或“反复上传失败”而放弃。API提供的实时检测与自动修正功能（如自动换底、裁剪），能显著降低操作门槛，提高流程完成率。
支持：替换背景、自动裁剪尺寸、设置分辨率、设置人脸在证件照中的占比、设置脸部中心在证件照中的位置、设置头顶距离
接口说明
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| base64 | String | 否 | 照片base64串 |
| file | File | 否 | 照片文件 |
| url | String | 否 | 照片url |
| spec | String | 否 | 证件照规格ID，见spec及bgColor参考 |
| bgColor | String | 否 | 证件照颜色值: blue, red, white等值，或者以井号开始的16进制颜色值：#FF0000，见spec及bgColor参考 |
| beautyDegree | Float | 否 | 美颜级别，浮点型，如1.5，取值范围[1.0-5.0]，超出范围后的值无效。主要调节了脸部黑白平衡。 |
| size | String | 否 | 证件照像素尺寸，格式:"宽x高"（中间分隔符为小写字母x），比如"480x640"。为了避免和spec内定的像素大小冲突，使用本参数的同时，需要将spec设置为"12"。 |
| fileSize | String | 否 | 证件照图片的文件大小， 如果期望证件照图片的文件大小（kb）在一定的限制范围内，可以设置这个值，值的单位为kb，格式为："最小值,最大值"，比如"10,100"表示希望返回的证件照文件大小在10-100kb之间；说明：该参数的单位为kb，而不是字节，如果文件大小如果设置不合理，比如过大或者过小，返回的文件大小有可能不在设定范围内。 |
| dpi | Integer | 否 | 返回的证件照分辨率，如果不设置该值，服务端会给出默认配置，一般返回300dpi的图片，个别证件照规格会返回350dpi的图片 |
| faceRatio | Float | 否 | 证件照中人脸占比参数，浮点类型，取值范围（0-1.0）不设置，则服务端会给出默认配置，一般为0.5，个别证件照规格为0.4，如果觉得我们返回的人脸过大或者过小，可以自行调节该值 |
| faceCenterRange | Float | 否 | 脸部中心高度在证件照中的位置，浮点类型，取值范围（0-1.0），默认值为0.45；这个参数可以决定人脸在证件照所处于的高度 |
| topEmpty | Float | 否 | 用来约定生成证件照中，头顶距离照片顶部的距离范围，格式为“最小值,最大值”（使用英文字母逗号分隔），单位为像素，比如期望生成的证件照，人的头顶留空最少10个像素，最多30个像素，可以给出值 "10,30" 。注意不能两个值都设置为0，最大值必须大于最小值，最大值不能大于等于证件照的高度。当这个值不设置时，不做头顶留空的判断。人脸在证件照中的高度位置定位原则说明：先根据face_center_y（默认值为0.45）来定位人脸高度位置，然后对比top_empty（如有设置）参数，调整人脸位置，使其符合top_empty要求，最后还会判断人体底部是否可能悬空（原图人像高度不够时可能会发生这个问题），如果出现悬空的现象，则需要将人像向下移动至不悬空的位置 |
base64、file、url 必须提供一个，优先级：base64 > file > url
返回样例
{
"code": 200,// 返回码，详见返回码说明
"msg": "成功", // 返回码对应描述
"taskNo": "254900443205524179659164",// 本次请求号
"charge": true,// 计费标志
"data": {
"result": "xxx.jpg",//证件照图片URL。有效期1天，请尽快下载保存
"size": [ //证件照尺寸[宽, 高]
"600",
"800"
]
}
}
