证件照制作接口

效果演示：请点击下载使用帮助文档，查看演示方法。

此接口为按次调用计费模式，结果不带水印。

如需要带水印预览免费，去水印下载计费的模式，请移步至”证件照制作高精版“接口，两个接口都是制作证件照，但产生的照片效果不同，计费模式不同，请不要将两者混用。

产品功能

根据客户发送的图像文件，分析图像中是否包含人像，如果包含人像，则自动去除原图中的背景，并按照证件照各种规格的要求，根据人像自动裁剪尺寸，替换背景。

可提供的服务

我们提供服务端接口调用API，客户仅需按我们的接入文档实现相关调用代码即可。同时我们可提供一定的定制服务，如判断参数的阈值等。退役军人优待证照片制作优化方案，请联系商务。

产品特点

1、证件照生成质量高、速度快，对发丝有极好的处理效果。

2、记费模式更划算：相比按去水印计费的模式，按调用次数计费方式的单用户成交成本便宜很多。

参数说明

参数名	类型	说明
photo	STRING	图片文件BASE64编码，图片格式为JPG和PNG两种类型； 注意，这里为图片文件的原始BASE64编码，不带如下头信息"data:image/jpg;base64,"；
type	STRING	图片类型，可不填写，支持jpg和png两种输入
photo_key	STRING	证件照检测等接口返回的photo_key值； 如果传入了photo_key参数，可以不再传photo和type参数； photo_key机制是为了多个相关接口联动而设计的，比如同一张图片，先调用“证件照环境检测接口”，再调用“证件照制作接口”，为了避免图片重复传输，可以使用photo_key机制用来标示图片的唯一性，photo_key有效期为2小时； 默认情况下，环境检测等接口不会返回photo_key，如果需要photo_key，可在相关接口请求参数中传入"with_photo_key": 1；
with_photo_key	INTEGER	可选参数，是否需要返回photo_key，photo_key可用于证件照相关其他接口使用，比如制作证件照后，再调用排版接口； 0-不返回（默认） 1-返回
spec	STRING	证件照规格ID，具体值可以从下面“资料下载”中下载资料“证件照规格列表”；
bk	STRING	证件照颜色值: blue, red, white等值，或者以井号开始的16进制颜色值：#FF0000，更多说明请从下面“资料下载”中下载资料“证件照规格列表”；
beauty_degree	FLOAT	可选参数，美颜级别，浮点型，如1.5，取值范围[1.0-5.0]，超出范围后的值无效。主要调节了脸部黑白平衡。
size	STRING	可选参数，证件照像素尺寸，格式:"宽x高"（中间分隔符为小写字母x），比如"480x640"。为了避免和spec内定的像素大小冲突，使用本参数的同时，需要将spec设置为"12"。
file_size	STRING	可选参数，如果期望证件照图片的文件大小（kb）在一定的限制范围内，可以设置这个值，值的单位为kb，格式为："最小值,最大值"，比如"10,100"表示希望返回的证件照文件大小在10-100kb之间； 说明： 该参数的单位为kb，而不是字节，如果文件大小如果设置不合理，比如过大或者过小，返回的文件大小有可能不在设定范围内。
dpi	INTEGER	可选参数，返回的证件照分辨率，如果不设置该值，服务端会给出默认配置，一般返回300dpi的图片，个别证件照规格会返回350dpi的图片，
face_ratio	FLOAT	可选参数，证件照中人脸占比参数，浮点类型，取值范围（0-1.0）不设置，则服务端会给出默认配置，一般为0.5，个别证件照规格为0.4，如果觉得我们返回的人脸过大或者过小，可以自行调节该值
face_center_y	FLOAT	可选参数，脸部中心高度在证件照中的位置，浮点类型，取值范围（0-1.0），默认值为0.45；这个参数可以决定人脸在证件照所处于的高度
top_empty	STRING	可选参数，用来约定生成证件照中，头顶距离照片顶部的距离范围，格式为“最小值,最大值”（使用英文字母逗号分隔），单位为像素，比如期望生成的证件照，人的头顶留空最少10个像素，最多30个像素，可以给出值 "10,30" 。注意不能两个值都设置为0，最大值必须大于最小值，最大值不能大于等于证件照的高度。当这个值不设置时，不做头顶留空的判断。 人脸在证件照中的高度位置定位原则说明：先根据face_center_y（默认值为0.45）来定位人脸高度位置，然后对比top_empty（如有设置）参数，调整人脸位置，使其符合top_empty要求，最后还会判断人体底部是否可能悬空（原图人像高度不够时可能会发生这个问题），如果出现悬空的现象，则需要将人像向下移动至不悬空的位置。
head_pose_correct	BOOL	可选参数，是否进行头部姿态矫正（正姿），默认关闭，如果需要开启正姿，可以将该值设置为"true", "yes"，"1"等值，如果关闭，可以不设置该值，或者将值设置为"false", "no", "0"等。
更多参数		如果以上参数不能满足需求，咨询技术支持

限制说明

1、接口对输入的图片像素尺寸有限制，最长边不超过2500个像素；

2、默认产品有调用频率限制，每秒10次调用，足够一般的业务场景使用。对于有特殊要求的应用场景，可以单独联系我们商务，我们可以单独放开这个频率限制。

3、制作的证件照图片链接有效期24小时，请及时下载保存。

包月服务

包月服务，需要联系商务旺旺单独开启。

价格如下：

4000元/月/qps（次/秒），现优惠价：3000元/月/qps

多买有优惠。

私有化部署

支持部署在客户的私有云上，不走公网。请联系商务接洽。

支持部署在安卓终端、windows电脑上，不走网络。请联系商务接洽。

其他说明

1、证件照规格列表在下面的“使用指南”中，请下载。

2、如果您需要按去水印付费的模式，请访问：证件照制作高精版

警告

请不要对我们线上服务进行机器压力测试，这有可能会影响其他客户的业务正常开展！

资料下载

示例代码、错误列表、演示地址、常见问题，请下载下面的《使用说明》：

《接口使用说明》

证件照批量制作工具（可将指定目录下所有jpg和png文件批量转为指定规格的证件照），从上面的《接口使用说明》中可以找到下载链接