证件照API接口，快速搭建证件照小程序（充值赠送小程序）

如果快速搭建证件照应用？

第一步可以先注册账号，注册后可以咨询客服，客服会赠送点数用于开发测试。

如需赠送证件照小程序，可滑到最底部，联系客服

证件照接口

地址：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	人脸是否正对摄像头误差范围，检测人脸pitch、yaw、roll三项误差值，示例	可选，越小越严格，越大容错率越高，默认：20	float
eyeskew	双眼倾斜误差范围	可选，越小越严格，越大容错率越高，默认：20	float
face_ratio_min	头部最小比例	可选，默认0.55	float
face_ratio	头部最大比例	可选，默认0.8	float
dpi	返回的证件照分辨率，如果不设置该值，服务端会给出默认配置，一般返回300dpi的图片	可选	int
head_top_gap_ratio	头顶发迹离上边缘距离	可选，默认0.08	float
eyes_to_botttom_ratio_min	眼睛离下边缘最小距离	可选，默认0.46	float
enhance_image_quality	是否对图像做清晰化处理	可选，默认为1，1表示是，0表示否	int
head_region	头部的计算区域，第一种计算区域为整个头部（含头发、耳朵），示例；第二种计算区域为脸颊，示例；	可选，默认0,0表示头部，1表示脸颊	int
align_face	在eyeskew参数误差范围内是否进行人脸自动矫正	可选，默认0，0表示不矫正，1表示矫正	int
glasses_glare	是否进行眼镜炫光检测	可选，默认0，0表示不检测，1表示检测	int
file_format	文件生成类型，支持jpg,png。默认png	可选，默认0，0表示png，1表示jpg	int
head_height_ratio_max	头部高度占比最大值	可选，默认1，示例值：0.7	float
head_height_ratio_min	头部高度占比最小值	可选，默认0.01，示例值：0.5	float
eye_distance_ratio_max	眼间距宽度占比最大值	可选，默认1，示例值：0.4	float
eye_distance_ratio_min	眼间距宽度占比最小值	可选，默认0.01，示例值：0.3	float
hat_check	检测是否佩戴帽子	可选，默认0不检测，1表示检测	int
glasses_check	检测是否佩戴眼镜	可选，默认0不检测，1表示检测	int
necklace_check	检测是否佩戴项链	可选，默认0不检测，1表示检测	int
earring_check	检测是否佩戴耳环	可选，默认0不检测，1表示检测	int
contrast_check	检测人像对比度	可选，示例值：20	int
brightness_check_min	检测人像亮度最小阈值，亮度阀值范围0-255	可选，示例值：20	int
brightness_check_max	检测人像亮度最大阈值	可选，示例值：220	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文档……