安全声明:本测试功能完全绿色免费,调用时直连对方服务器,本站不做任何转发且不存储您的任何Token,请放心使用!
基础配置
API 简单身份认证(APPCODE),格式为APPCODE {APPCODE}
选择接入点:
POST
接入点文档:查看
Run: Ctrl+
接入点描述:证件照制作
请求参数
base64
照片base64串,base64、url 必须提供一个,优先级:base64 > url
url
照片url,base64、url 必须提供一个,优先级:base64 > url
spec
证件照规格ID,见spec及bgColor参考
bgColor
件照颜色值: blue, red, white等值,或者以井号开始的16进制颜色值:#FF0000,见spec及bgColor参考
size
证件照像素尺寸,格式:”宽x高”(中间分隔符为小写字母x),比如”480x640”。为了避免和spec内定的像素大小冲突,使用本参数的同时,需要将spec设置为”12”。
dpi
返回的证件照分辨率,如果不设置该值,服务端会给出默认配置,一般返回300dpi的图片,个别证件照规格会返回350dpi的图片
faceRatio
证件照中人脸占比参数,浮点类型,取值范围(0-1.0)不设置,则服务端会给出默认配置,一般为0.5,个别证件照规格为0.4,如果觉得我们返回的人脸过大或者过小,可以自行调节该值
faceCenterRange
脸部中心高度在证件照中的位置,浮点类型,取值范围(0-1.0),默认值为0.45;这个参数可以决定人脸在证件照所处于的高度
topEmpty
用来约定生成证件照中,头顶距离照片顶部的距离范围,格式为“最小值,最大值”(使用英文字母逗号分隔),单位为像素,比如期望生成的证件照,人的头顶留空最少10个像素,最多30个像素,可以给出值 “10,30” 。注意不能两个值都设置为0,最大值必须大于最小值,最大值不能大于等于证件照的高度。当这个值不设置时,不做头顶留空的判断。人脸在证件照中的高度位置定位原则说明:先根据face_center_y(默认值为0.45)来定位人脸高度位置,然后对比top_empty(如有设置)参数,调整人脸位置,使其符合top_empty要求,最后还会判断人体底部是否可能悬空(原图人像高度不够时可能会发生这个问题),如果出现悬空的现象,则需要将人像向下移动至不悬空的位置
fileSize
证件照图片的文件大小, 如果期望证件照图片的文件大小(kb)在一定的限制范围内,可以设置这个值,值的单位为kb,格式为:”最小值,最大值”,比如”10,100”表示希望返回的证件照文件大小在10-100kb之间;说明:该参数的单位为kb,而不是字节,如果文件大小如果设置不合理,比如过大或者过小,返回的文件大小有可能不在设定范围内。
beautyDegree
美颜级别,浮点型,如1.5,取值范围[1.0-5.0],超出范围后的值无效。主要调节了脸部黑白平衡。
返回结果
当前为示例返回
更多接入点测试
使用其他软件测试API
您可以拷贝Curl语句,直接导入Postman进行测试