base64 string | N | 照片base64串，base64、url 必须提供一个，优先级：base64 > url |
url string | N | 照片url，base64、url 必须提供一个，优先级：base64 > url |
spec string | N | |
bgColor string | N | 件照颜色值: blue, red, white等值，或者以井号开始的16进制颜色值：#FF0000，见spec及bgColor参考 |
beautyDegree string | N | 美颜级别，浮点型，如1.5，取值范围[1.0-5.0]，超出范围后的值无效。主要调节了脸部黑白平衡。 |
size string | N | 证件照像素尺寸，格式:”宽x高”（中间分隔符为小写字母x），比如”480x640”。为了避免和spec内定的像素大小冲突，使用本参数的同时，需要将spec设置为”12”。 |
fileSize string | N | 证件照图片的文件大小， 如果期望证件照图片的文件大小（kb）在一定的限制范围内，可以设置这个值，值的单位为kb，格式为：”最小值,最大值”，比如”10,100”表示希望返回的证件照文件大小在10-100kb之间；说明：该参数的单位为kb，而不是字节，如果文件大小如果设置不合理，比如过大或者过小，返回的文件大小有可能不在设定范围内。 |
dpi string | N | 返回的证件照分辨率，如果不设置该值，服务端会给出默认配置，一般返回300dpi的图片，个别证件照规格会返回350dpi的图片 |
faceRatio string | N | 证件照中人脸占比参数，浮点类型，取值范围（0-1.0）不设置，则服务端会给出默认配置，一般为0.5，个别证件照规格为0.4，如果觉得我们返回的人脸过大或者过小，可以自行调节该值 |
faceCenterRange string | N | 脸部中心高度在证件照中的位置，浮点类型，取值范围（0-1.0），默认值为0.45；这个参数可以决定人脸在证件照所处于的高度 |
topEmpty string | N | 用来约定生成证件照中，头顶距离照片顶部的距离范围，格式为“最小值,最大值”（使用英文字母逗号分隔），单位为像素，比如期望生成的证件照，人的头顶留空最少10个像素，最多30个像素，可以给出值 “10,30” 。注意不能两个值都设置为0，最大值必须大于最小值，最大值不能大于等于证件照的高度。当这个值不设置时，不做头顶留空的判断。人脸在证件照中的高度位置定位原则说明：先根据face_center_y（默认值为0.45）来定位人脸高度位置，然后对比top_empty（如有设置）参数，调整人脸位置，使其符合top_empty要求，最后还会判断人体底部是否可能悬空（原图人像高度不够时可能会发生这个问题），如果出现悬空的现象，则需要将人像向下移动至不悬空的位置 |
用户评论 (14)
技术客服支持很好的，很快定位问题就给解决了
调用挺方便快捷的
接入确实挺方便，有问题反馈也能及时解决
接口对接特别快，发票也开的快，申请之后很快就开好了
到目前为止都挺满意的！
技术客服支持很好的，很快定位问题就给解决了
免费次数够多，测试足够了。效率很高
他们家的售后服务很好，解答的很全面很仔细！
可以，能用。五星好评！！！
接口一调就通了，太满意了，下次还来