可立图证件照API实现智能证件照制作

可立图是一个可以智能人像抠图的网站，同时也提供证件照制作服务

使用可立图证件照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时表示点数已用完

如果想调用证件照换装接口，证件照美颜等接口，可进入官网查看详细文档