基本信息

请求类型: HTTP/HTTPS

接口地址: http://apicall.id-photo-verify.com/api/cut_change_clothes

请求方式: POST

数据类型: JSON

响应类型: JSON

接口状态: 启用

接口描述：

对原图按证件照规格裁剪，并为其换上正装。

调用此接口不扣使用次数，通过此接口的返文件名去获取无水印图片，扣3次使用次数。同一个图片名称（包括单张和排版），如果需要再次获取，不会增加已调用次数

官网上对应的app_key应用类型必须为裁剪换正装

请求参数

参数名称	是否必须	类型	描述
file	FALSE	string	图片的base64格式(注意不包含base64的头部数据)，或者图片在oss的key（见第13个接口）
app_key	TRUE	string	已申请的app_key
spec_id	TRUE	int	规格id,见页面上方的‘照片规格列表’
width_px	FALSE	int	自定义像素宽度值，最大不能超过1050
height_px	FALSE	int	自定义像素高度值，最大不能超过1500
clothes	TRUE	string	正装模板名称,见下方表格
fair_level	FALSE	dict	美颜级别（默认为0，代表不美颜，级别0-1，美颜程度依次增强），见参数说明3
origin_pic_name	FALSE	string	初始图片名称，同一张照片进行不同换装时，请传入此参数
background_color	FALSE	list	自定义照片背景色，详见参数说明4
ratios	FALSE	list	自定义证件照制作比率，详见参数说明5
file_size_max	FALSE	int	文件大小最大值
file_size_min	FALSE	int	文件大小最小值
print_type	FALSE	int	排版类型，1表示默认（一寸8张），2表示紧凑型（一寸10张）
need_adjust_lighting	FALSE	int	是否需要做光照处理，1表示是，0表示否，默认否
enhanced_type	FALSE	int	图像增强控制参数，1表示不增强，2表示粗裁剪增强，3表示结果图增强，默认不增强，详细见参数说明6
hor_align_type	FALSE	int	裁剪方式 0表示中心裁剪(默认) 1表示耳朵裁剪

响应参数

参数名称	类型	参数说明
code	int	状态码
final_pic_name	list	无水印图片名称列表（同‘带水印图片url列表’顺序），调获取无水印图片接口，进行获取。
origin_pic_name	str	原始图片名
print_pic_name	list	无水印排版图片名称列表（同‘带水印图片url列表’顺序），调获取无水印图片接口，进行获取。
print_wm_pic_url	list	带水印排版图片url列表（同‘带水印图片url列表’顺序）
wm_pic_url	list	带水印图片url列表
error	str	错误信息提示
one_sheet_num	int	排版的照片数量
source_file	str	原图的云端存储路径（使用此路径作为此接口请求中的file将大大提高效率）
big_pic_wm_url	str	结果图等比例的放大透明背景图

python请求示例

import requests, json

url = "http://apicall.id-photo-verify.com/api/cut_change_clothes"

with open("test.png", 'rb') as f:
    pic = f.read()

headers = {"Content-Type": "application/json"}

data = {
    "spec_id": 3,
    "app_key": "对应的app_key",
    "file": base64.b64encode(pic).decode(),
    # 再次换装时，只需要传入下方的参数即可
    # "origin_pic_name": "83da1ba4dab211e9ab4900163e0aee01.jpg",
    "fair_level": 0,
    "clothes": "applet_boy1",
}
data_json = json.dumps(data)
start = time.time()
response = requests.post(
    url=url,
    headers=headers,
    data=data_json)
print(response.text)

响应示例

{
  "code": 200, 
  "final_pic_name": [
    "2c585d52968f11ea9d1100163e0070b6clothesred"
  ], 
  "one_sheet_num": 8, 
  "origin_pic_name": "2c585d52968f11ea9d1100163e0070b6.jpg", 
  "print_pic_name": [
    "2c585d52968f11ea9d1100163e0070b6clothesred_print"
  ], 
  "print_wm_pic_url": [
    "https://leqi-imgcall.oss-cn-shanghai.aliyuncs.com/result_wm%2F2c
		585d52968f11ea9d1100163e0070b6red_print.jpg?OSSAccessKeyId=LTAIQ8
		Lif1HHVkXd&Expires=1589621634&Signature=lwVKr6MRCBlXggiWMIP0BVi5nhg%3D"
  ], 
  "wm_pic_url": [
    "https://leqi-imgcall.oss-cn-shanghai.aliyuncs.com/result_wm%2F2c5
		85d52968f11ea9d1100163e0070b6red.jpg?OSSAccessKeyId=LTAIQ8Lif1H
		HVkXd&Expires=1589621634&Signature=bDV8FnrjU1Kyx77Uvf81mYdfVm8%3D"
  ]
}

模板信息：

正装模板名称	模板预览图片	描述
applet_boy1		男装模板1
applet_boy2		男装模板2
applet_boy3		男装模板3
applet_boy4		男装模板4
applet_boy5		男装模板5
applet_boy6		男装模板6
applet_boy7		男装模板7
applet_boy8		男装模板8
applet_boy9		男装模板9
applet_boy10		男装模板10
applet_boy11		男装模板11
applet_boy12		男装模板12
applet_boy13		男装模板13
applet_boy14		男装模板14
applet_boy15		男装模板15
applet_boy16		男装模板16
applet_boy17		男装模板17
applet_girl1		女装模板1
applet_girl2		女装模板2
applet_girl3		女装模板3
applet_girl4		女装模板4
applet_girl5		女装模板5
applet_girl6		女装模板6
applet_girl7		女装模板7
applet_girl8		女装模板8
applet_girl9		女装模板9
applet_girl10		女装模板10
applet_girl11		女装模板11
applet_girl12		女装模板12
applet_girl13		女装模板13
applet_girl14		女装模板14
applet_girl15		女装模板15
applet_girl16		女装模板16
applet_girl17		女装模板17
applet_kid1		童装模板1
applet_kid2		童装模板2
applet_kid3		童装模板3
applet_kid4		童装模板4
applet_kid5		童装模板5
applet_kid6		童装模板6
applet_kid7		童装模板7
applet_kid8		童装模板8
applet_kid9		童装模板9
applet_kid10		童装模板10
applet_kid11		童装模板11
applet_kid12		童装模板12
applet_kid13		童装模板13
applet_kid14		童装模板14
applet_kid15		童装模板15
applet_kid16		童装模板16
applet_kid17		童装模板17
applet_kid18		童装模板18
applet_kid19		童装模板19
applet_kid20		童装模板20
applet_kid21		童装模板21
applet_kid22		童装模板22
applet_kid23		童装模板23