首页 > 其他分享 >智能证件照api——可立图一键抠图工具

智能证件照api——可立图一键抠图工具

时间:2022-08-24 15:27:06浏览次数:67  
标签:必选 string httpcode api 参数 https 可立 证件照

可立图是一家可以在线智能抠图的网站,同时也可以一键生成证件照

提供了抠图api服务和证件照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时表示图片不存在

5.证件照排版下载

地址: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时表示点数已用完

 

更多证件照接口,如换装接口,美颜接口等可以登录可立图网站查看

标签:必选,string,httpcode,api,参数,https,可立,证件照
From: https://www.cnblogs.com/clipimg/p/16620026.html

相关文章