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

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

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