证件照制作-证件照生成-证件照优化API接口介绍

原创

聚美智数

修改于 2026-03-03 15:21:10

使用证件照制作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"
    ]
  }
}

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api