给大家介绍一家证件照API接口服务商，可立图，专门做抠图等图片处理的一家公司，下载仅需
0.3元，对比了一下，全网最低价了。
API文档地址
主要两个接口
证件照接口，能设置人像的位置大小间距等等，能满足所需规格的要求；还可以设置清晰度
换装接口，可以换装(换装api免费调用)，满足需要正装的场景
调用流程是先传照片，然后调用预览接口预览生成的证件照，这一步不需要花钱，你在你业务中给你的客户预览，他满意了付费了你再调用下载原图的接口，这一步要扣费，大概3毛，成本可控。目前市场上一张电子证件照2-4元不等，利润空间还是很大的
第一步可以先注册账号，注册后可以资讯客服，客服会赠送点数用于开发测试。
1.证件照接口
地址：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 |
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账户30点余额，大约0.3元
参数[Header]
| 参数名 | 说明 | 是否必选 | 类型 |
| X-API-Key | 秘钥 | 必选 | string |
| Content-Type | 请求数据类型 | 必选 | application/json |
参数[Body]：
返回：httpcode为200时返回图片流
httpcode为404时表示图片不存在
httpcode为402时表示点数已用完
5.证件照排版预览
地址：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账户50点余额，换装排版照扣100点余额 ，约1元
参数[Header]
| 参数名 | 说明 | 是否必选 | 类型 |
| X-API-Key | 秘钥 | 必选 | string |
| Content-Type | 请求数据类型 | 必选 | application/json |
参数[Body]：
返回：httpcode为200时返回图片流
httpcode为404时表示图片不存在
httpcode为402时表示点数已用完
7.证件照换装
地址：https://www.clipimg.com/api/idphoto/change_clothes
请求方式：POST
数据类型：JSON
响应类型：JSON
接口描述：此接口为证件照换装制作接口，调用不产生费用，结果保留1小时，1小时后自动删除制作结果图片，请及时保存。重复下载同一张照片不会重复扣费。
参数[Header]
| 参数名 | 说明 | 是否必选 | 类型 |
| X-API-Key | 秘钥 | 必选 | string |
| Content-Type | 请求数据类型 | 必选 | application/json |
参数[Body]：
| 参数名 | 说明 | 是否必选 | 类型 |
| img_name | 证件照图片名称 | 可选 | string |
| file | Base64格式图片，不包含base64的头部数据 | img_name不传值时必选 | string |
| clothes_id | 服装id | 必选 | int |
| bg_color | 您所上传的证件照图片的背景色，16进制表示，eg：#02A7F0 | 必选 | string |
| enc_color | 您所上传的证件照图片渐变色色值，可选，不传值时为纯色背景 | 可选 | string |
| dpi | 返回的证件照分辨率，如果不设置该值，服务端会给出默认配置，一般返回300dpi的图片 | 可选 | int |
返回：
| 参数 | 说明 | 示例 | 类型 |
| code | 状态码 | 0 | int |
| msg | 错误详情 | 成功 | string |
| data | 结果 |
code取值
| 0 | 成功 |
| 400 | 参数错误 |
| 402 | 点数已用完 |
| 410 | 未检测到人脸 |
| 411 | 未检测到脖子 |
| 415 | 换装异常 |
data结构体
| 参数名称 | 说明 | 示例值 | 类型 |
| download_url | 下载地址 | https://… | string |
| preview_url | 预览地址 | https://… | string |
| img_name | 原图名称 | 9ad…._changeCloth | string |
| preview_img_name | 预览图名称 | 9ad…._changeCloth_preview | string |
| print_img_name | 排版照下载名称（注：在6证件照排版下载接口中使用） | 9ad…._changeCloth_print | string |
| print_url | 排版照下载地址 | https://… | string |
| preview_print_url | 排版照预览地址 | https://… | string |
| preview_print_img_name | 排版照预览名称（注：在5证件照排版预览接口中使用） | 9ad…._changeCloth_print_preview | string |
8.证件照换装预览
地址：https://www.clipimg.com/api/idphoto/change_clothes/preview/预览图片名称
请求方式：GET
数据类型：JSON
响应类型：Image
计费：此接口不产生费用
参数：无
返回：httpcode为200时返回图片流
httpcode为404时表示图片不存在
9.证件照换装下载
地址：https://www.clipimg.com/api/idphoto/change_clothes/download/换装证件照图片名称
请求方式：POST
数据类型：JSON
响应类型：Image
计费：此接口调用成功扣除API账户30点余额。大约0.3元
参数[Header]
| 参数名 | 说明 | 是否必选 | 类型 |
| X-API-Key | 秘钥 | 必选 | string |
| Content-Type | 请求数据类型 | 必选 | application/json |
返回：httpcode为200时返回图片流
httpcode为404时表示图片不存在
httpcode为402时表示点数已用完
1505
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
