请求类型: 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表示耳朵裁剪 | |
| out_endpoint | FALSE | str | 控制返回链接的域名,见参数说明7 | |
| pose_fix | false | int | 是否需要做姿态调整 0表示否(默认,头像摆正依据双眼水平) 1表示是(会矫正双眼水平和肩膀水平) | 1 |
| need_origin_beauty | false | int | 是否需要对原图进行预美颜处理, 1表示是,0表示否,默认否,为1时接口耗时偶尔会额外增加30-40秒,大多数情况下额外增加5-6秒 | 1 |
| origin_max_length | false | int | 原图缩放参数,传此参数时,原图最长边像素大于此值时会被等比例缩放到此值,此时接口耗时会相对较短,且更加稳定,推荐传此参数为1500;不传此参数时不缩放(默认不缩放). | 1500 |
| 参数名称 | 类型 | 参数说明 |
|---|---|---|
| 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 | 结果图等比例的放大透明背景图 |
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"
]
}
| 正装模板名称 | 模板预览图片 | 描述 |
|---|---|---|
| api_20240521-1-boy | ![]() |
男装模板1 |
| api_20240521-2-boy | ![]() |
男装模板2 |
| api_20240521-3-boy | ![]() |
男装模板3 |
| api_20240521-4-boy | ![]() |
男装模板4 |
| api_20240521-5-boy | ![]() |
男装模板5 |
| api_20240521-6-boy | ![]() |
男装模板6 |
| api_20240521-8-boy | ![]() |
男装模板7 |
| api_20240521-9-boy | ![]() |
男装模板8 |
| api_20240521-10-boy | ![]() |
男装模板9 |
| api_20240521-11-boy | ![]() |
男装模板10 |
| api_20240521-12-boy | ![]() |
男装模板11 |
| api_20240521-13-boy | ![]() |
男装模板12 |
| api_20240521-14-boy | ![]() |
男装模板13 |
| api_20240521-15-boy | ![]() |
男装模板14 |
| api_20240521-16-boy | ![]() |
男装模板15 |
| api_20240521-17-boy | ![]() |
男装模板16 |
| api_20240521-18-boy | ![]() |
男装模板17 |
| api_20240521-19-boy | ![]() |
男装模板18 |
| api_20240521-20-boy | ![]() |
男装模板19 |
| api_20240521-21-boy | ![]() |
男装模板20 |
| api_20240521-1-girl | ![]() |
女装模板1 |
| api_20240521-2-girl | ![]() |
女装模板2 |
| api_20240521-3-girl | ![]() |
女装模板3 |
| api_20240521-4-girl | ![]() |
女装模板4 |
| api_20240521-5-girl | ![]() |
女装模板5 |
| api_20240521-6-girl | ![]() |
女装模板6 |
| api_20240521-7-girl | ![]() |
女装模板7 |
| api_20240521-8-girl | ![]() |
女装模板8 |
| api_20240521-9-girl | ![]() |
女装模板9 |
| api_20240521-10-girl | ![]() |
女装模板10 |
| api_20240521-11-girl | ![]() |
女装模板11 |
| api_20240521-12-girl | ![]() |
女装模板12 |
| api_20240521-13-girl | ![]() |
女装模板13 |
| api_20240521-14-girl | ![]() |
女装模板14 |
| api_20240521-15-girl | ![]() |
女装模板15 |
| api_20240521-16-girl | ![]() |
女装模板16 |
| api_20240521-17-girl | ![]() |
女装模板17 |
| api_20240521-1-kid | ![]() |
童装模板1 |
| api_20240521-2-kid | ![]() |
童装模板2 |
| api_20240521-3-kid | ![]() |
童装模板3 |
| api_20240521-4-kid | ![]() |
童装模板4 |
| api_20240521-5-kid | ![]() |
童装模板5 |
| api_20240521-6-kid | ![]() |
童装模板6 |
| api_20240521-7-kid | ![]() |
童装模板7 |
| api_20240521-8-kid | ![]() |
童装模板8 |
| api_20240521-9-kid | ![]() |
童装模板9 |
| api_20240521-10-kid | ![]() |
童装模板10 |
| api_20240521-11-kid | ![]() |
童装模板11 |
| api_20240521-12-kid | ![]() |
童装模板12 |
| api_20240521-13-kid | ![]() |
童装模板13 |
| api_20240521-14-kid | ![]() |
童装模板14 |
| api_20240521-15-kid | ![]() |
童装模板15 |
| api_20240521-16-kid | ![]() |
童装模板16 |
| api_20240521-17-kid | ![]() |
童装模板17 |
| 正装模板名称 | 模板预览图片 | 描述 |
|---|---|---|
| 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 |