可立图证件照API-快速搭建智能证件照应用

1.人像抠图接口

地址：https://www.clipimg.com/api/human/matting

请求方式：POST

数据类型：form

计费：formate为png或zip时调用成功扣除50点，formate为json时下载无水印结果图片再扣除50点、请求有水印图片不扣点

参数[Header]

参数名	说明	是否必选	类型
X-API-Key	秘钥	必选	string
Content-Type	请求数据类型	必选	multipart/form-data 或 application/json

参数[Body]：

参数名	说明	是否必选	类型
file	content-type为multipart/form-data时传递图片二进制流，为application/json时传递图片的base64格式，不包含base64的头部数据	必选	二进制流、string
formate	返回数据格式	可选	string

formate取值

png	人像透明图片
zip	包含alpha图片的人像alpha图片
json	json格式数据，包含预览图（含水印）地址和下载（无水印）地址，预览免费，下载无水印图片扣费

返回:

httpcode为200时：formate不传值或传png时，返回png二进制流；为zip时返回包含alpha文件、png文件的zip压缩包二进制流；为json格式时数据，返回json格式数据，包含预览图（含水印）地址和下载（无水印）地址，预览免费，下载无水印图片扣费

httpcode为402时表示点数已用完

httpcode为400时表示文件上传错误

httpcode为413时表示文件上传超过大小限制

httpcode为403时表示账号异常

2.证件照接口

地址：https://www.clipimg.com/api/idphoto/make

请求方式：POST

数据类型：JSON

响应类型：JSON

计费：此接口不产生费用

接口描述：此接口为证件照制作接口，调用不产生费用，结果保留1小时，1小时后自动删除制作结果图片，请及时保存。重复下载同一张照片不会重复扣费。

参数[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.6	float
face_ratio	头部最大比例	可选，默认0.67	float
dpi	返回的证件照分辨率，如果不设置该值，服务端会给出默认配置，一般返回300dpi的图片	可选	int
head_top_gap_ratio	头顶发迹离上边缘距离	可选，默认0.1	float
eyes_to_botttom_ratio_min	眼睛离下边缘最小距离	可选，默认0.46	float
enhance_image_quality	是否对图像做清晰化处理	可选，默认为1，1表示是，0表示否	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

 

更多接口请求方法，可进入可立图网站查看api文档……