- API
- 证件照制作无水印接口
POST/idphoto/make
无参数
无参数
- 接口文档
- 请求示例
- 成功响应
- 失败响应
- 错误码
- 调用结果
接口信息
https://idp2.market.alicloudapi.com/idphoto/make
POST
JSON
API 简单身份认证调用方法(APPCODE)API 签名认证调用方法(AppKey & AppSecret)
接口参数
请求参数(Header)
字段名称 | 必填 | 字段详情 |
---|---|---|
无参数 |
请求参数(Query)
字段名称 | 必填 | 字段详情 |
---|---|---|
无参数 |
请求参数(Body)
商品介绍
产品亮点
产品说明
效果演示:请点击下载使用帮助文档,查看演示方法。
此接口为按次调用计费模式,结果不带水印。
如需要带水印预览免费,去水印下载计费的模式,请移步至”证件照制作高精版“接口,两个接口都是制作证件照,但产生的照片效果不同,计费模式不同,请不要将两者混用。
产品功能
根据客户发送的图像文件,分析图像中是否包含人像,如果包含人像,则自动去除原图中的背景,并按照证件照各种规格的要求,根据人像自动裁剪尺寸,替换背景。
可提供的服务
我们提供服务端接口调用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要求,最后还会判断人体底部是否可能悬空(原图人像高度不够时可能会发生这个问题),如果出现悬空的现象,则需要将人像向下移动至不悬空的位置。 |
更多参数 | 如果以上参数不能满足需求,咨询技术支持 |
限制说明
1、接口对输入的图片像素尺寸有限制,最长边不超过2500个像素;
2、默认产品有调用频率限制,每秒10次调用,足够一般的业务场景使用。对于有特殊要求的应用场景,可以单独联系我们商务,我们可以单独放开这个频率限制。
3、制作的证件照图片链接有效期24小时,请及时下载保存。
包月服务
包月服务,需要联系商务旺旺单独开启。
价格如下:
4000元/月/qps(次/秒),现优惠价:3000元/月/qps
多买有优惠。
私有化部署
支持部署在客户的私有云上,不走公网。请联系商务接洽。
支持部署在安卓终端、windows电脑上,不走网络。请联系商务接洽。
其他说明
1、证件照规格列表在下面的“使用指南”中,请下载。
2、如果您需要按去水印付费的模式,请访问:证件照制作高精版
警告
请不要对我们线上服务进行机器压力测试,这有可能会影响其他客户的业务正常开展!
资料下载
示例代码、错误列表、演示地址、常见问题,请下载下面的《使用说明》:
证件照批量制作工具(可将指定目录下所有jpg和png文件批量转为指定规格的证件照),从上面的《接口使用说明》中可以找到下载链接
产品参数
交付方式 | API |
开票主体 | 北京玩星汇聚科技有限公司 |
所属类目 | AI应用与OCR |
上架日期 | 2018-09-08 |
产品截图
售后支持范围
产品资质
商品价格(此处价格仅供参考,实际价格以选配后的价格为准)
版本名称 | 计费项 | 新购 |
100次包 | 版本基础价格 | 8元 |
200次包 | 版本基础价格 | 16元 |
尝鲜包 | 版本基础价格 | 180元 |
入门包 | 版本基础价格 | 850元 |
实惠包A | 版本基础价格 | 2000元 |
实惠包B | 版本基础价格 | 3000元 |
50万次包 | 版本基础价格 | 10000元 |
100万次包 | 版本基础价格 | 18000元 |
包月联系商务 | 版本基础价格 | 5元 |
使用指南
立即下载客户案例
以下日活过十万的小程序都使用了我们的证件照接口:
微信平台上的小程序:标准证件照
支付宝平台上的小程序:免费电子证件照制作-顺势科技
用户评论 (21)
好好
不错
不错
还没有开始用,评价什么。
很好
强
挺好的
很棒,功能强大,使用方便!技术支持也很到位,赞就一个字,我可以说很多次
挺好的
一直在用,祝贵公司新年更大发展,我们永远支持贵司的服务。