商品介绍
产品亮点
产品说明
效果演示：请点击下载使用帮助文档，查看演示方法。
此接口为按次调用计费模式，结果不带水印。
如需要带水印预览免费，去水印下载计费的模式，请移步至”证件照制作高精版“接口，两个接口都是制作证件照，但产生的照片效果不同，计费模式不同，请不要将两者混用。
产品功能
根据客户发送的图像文件，分析图像中是否包含人像，如果包含人像，则自动去除原图中的背景，并按照证件照各种规格的要求，根据人像自动裁剪尺寸，替换背景。
可提供的服务
我们提供服务端接口调用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文件批量转为指定规格的证件照），从上面的《接口使用说明》中可以找到下载链接
产品参数
| 交付方式 | API |
| 开票主体 | 北京玩星汇聚科技有限公司 |
| 所属类目 | AI应用与OCR |
| 上架日期 | 2018-09-08 |
产品截图
用户评论 (21)
好好
不错
不错
还没有开始用，评价什么。
很好
强
挺好的
很棒，功能强大，使用方便！技术支持也很到位，赞就一个字，我可以说很多次
挺好的
一直在用，祝贵公司新年更大发展，我们永远支持贵司的服务。