可立图是一个可以智能人像抠图的网站,同时也提供证件照制作服务
使用可立图证件照api可实现不限制背景的证件照制作
还可实现证件照换装,证件照换底色等多种功能。如何使用可立图证件照api:
1.注册可立图网站:https://www.clipimg.com
2.注册后进入个人中心找到apikey,如要调用调试,可向客服申请免费api额度
3.证件照api调用方式如下:
1.证件照接口
地址:https://www.clipimg.com/api/idphoto/make
请求方式:POST
数据类型:JSON
响应类型:JSON
计费:此接口不产生费用
参数[Header]
参数名 | 说明 | 是否必选 | 类型 |
X-API-Key | 秘钥 | 必选 | string |
Content-Type | 请求数据类型 | 必选 | application/json |
参数[Body]:
参数名 | 说明 | 是否必选 | 类型 |
file | 图片的base64格式,不包含base64的头部数据 | 必选 | string |
spec_id | 规格id | 可选,width、height不传值时必传 | int |
width | 宽度px | 可选,spec_id不传值时必传 | int |
height | 高度px | 可选,spec_id不传值时必传 | int |
fair_level | 美颜级别 | 可选,0-1之间的小数,为0时不美颜 | float |
color | 背景色 | 可选,默认值蓝红白三种颜色 | list |
facepose | 人脸是否正对摄像头误差范围 | 可选,越小越严格,越大容错率越高,默认:20 | float |
eyeskew | 双眼倾斜误差范围 | 可选,越小越严格,越大容错率越高,默认:20 | float |
face_ratio_min | 人脸最小比率 | 可选,默认0.4 | float |
face_ratio | 小于最小比例后放大比例 | 可选,默认0.52 | float |
dpi | 返回的证件照分辨率,如果不设置该值,服务端会给出默认配置,一般返回300dpi的图片 | 可选 | int |
color结构
参数名 | 说明 | 类型 |
name | 背景色名称 | string |
start_color | 背景色值 | strng |
enc_color | 渐变色色值,可选,不传值时为纯色背景 | string |
返回:
参数 | 说明 | 示例 | 类型 |
code | 状态码 | 0 | int |
msg | 错误详情 | 成功 | string |
data | 结果 |
code取值
0 | 请求成功 |
402 | 点数已用完 |
407 | 未检测到人脸 |
408 | 包含多人 |
412 | 双眼倾斜,超过误差范围 |
413 | 人脸倾斜,超过误差范围 |
data结构体
参数名 | 说明 | 示例值 | 类型 |
image_id | 上传图片的标示 | d00a42c…0dc18946 | string |
filenames | 证件照列表 | [{‘preview_url’: ‘https://…’, ‘preview_img_name’: ‘d00a4…_white_preview’, ‘download_url’: ‘https://…’, ‘img_name’: ‘d00a4…_white’, ‘color_name’: ‘white’,’bg_color’: ‘#FFFFFF’}, …] | list |
filenames结构
参数名 | 说明 | 示例值 | 类型 |
preview_url | 预览图片地址 | https://… | string |
preview_img_name | 预览图名称,用于再次下载 | d00a4…_white | string |
download_url | 原图下载地址 | https://… | string |
img_name | 证件照名称,用于再次下载、换装 | d00a4…_white | string |
color_name | 背景色名称 | white | string |
bg_color | 背景色色值 | #FFFFFF | string |
print_img_name | 打印排版照原图名称 | d00a4…_print_white | string |
preview_print_img_name | 打印排版照预览图名称 | d00a4…_print_white | string |
print_url | 排版照原图下载地址 | https://… | string |
preview_print_url | 排版照预览图下载地址 | https://… | string |
2.证件照预览
地址:https://www.clipimg.com/api/idphoto/preview/预览图片名称
请求方式:GET
数据类型:JSON
响应类型:Image
计费:此接口不产生费用
参数:无
返回:httpcode为200时返回图片流
httpcode为404时表示图片不存在
3.证件照下载
地址:https://www.clipimg.com/api/idphoto/download/证件照图片名称
请求方式:POST
数据类型:JSON
响应类型:Image
计费:此接口调用成功扣除API账户50点余额
参数[Header]
参数名 | 说明 | 是否必选 | 类型 |
X-API-Key | 秘钥 | 必选 | string |
Content-Type | 请求数据类型 | 必选 | application/json |
参数[Body]:
返回:httpcode为200时返回图片流
httpcode为404时表示图片不存在
httpcode为402时表示点数已用完
4.证件照排版预览
地址:https://www.clipimg.com/api/idphoto/print_preview/打印排版照预览图名称
请求方式:GET
数据类型:JSON
响应类型:Image
计费:此接口不产生费用
参数:无
返回:httpcode为200时返回图片流
httpcode为404时表示图片不存在
6.证件照排版下载
地址:https://www.clipimg.com/api/idphoto/print_download/打印排版照原图名称
请求方式:POST
数据类型:JSON
响应类型:Image
计费:此接口调用成功扣除API账户30点余额,换装排版照扣100点余额
参数[Header]
参数名 | 说明 | 是否必选 | 类型 |
X-API-Key | 秘钥 | 必选 | string |
Content-Type | 请求数据类型 | 必选 | application/json |
参数[Body]:
返回:httpcode为200时返回图片流
httpcode为404时表示图片不存在
httpcode为402时表示点数已用完
如果想调用证件照换装接口,证件照美颜等接口,可进入官网查看详细文档
原文地址:https://www.jb51.cc/wenti/3282171.html
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。