请求类型: 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 |