证件照制作-证件照生成-证件照优化API接口介绍
【摘要】 使用证件照制作API的核心原因在于解决传统证件照拍摄和制作过程中的效率低、成本高、标准难统一、用户体验差等痛点。支持:替换背景、自动裁剪尺寸、设置分辨率、设置人脸在证件照中的占比、设置脸部中心在证件照中的位置、设置头顶距离。
使用证件照制作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"
]
}
}
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)