剪裁换正装

基本信息

请求类型: 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 img 男装模板1
applet_boy2 img 男装模板2
applet_boy3 img 男装模板3
applet_boy4 img 男装模板4
applet_boy5 img 男装模板5
applet_boy6 img 男装模板6
applet_boy7 img 男装模板7
applet_boy8 img 男装模板8
applet_boy9 img 男装模板9
applet_boy10 img 男装模板10
applet_boy11 img 男装模板11
applet_boy12 img 男装模板12
applet_boy13 img 男装模板13
applet_boy14 img 男装模板14
applet_boy15 img 男装模板15
applet_boy16 img 男装模板16
applet_boy17 img 男装模板17
applet_girl1 img 女装模板1
applet_girl2 img 女装模板2
applet_girl3 img 女装模板3
applet_girl4 img 女装模板4
applet_girl5 img 女装模板5
applet_girl6 img 女装模板6
applet_girl7 img 女装模板7
applet_girl8 img 女装模板8
applet_girl9 img 女装模板9
applet_girl10 img 女装模板10
applet_girl11 img 女装模板11
applet_girl12 img 女装模板12
applet_girl13 img 女装模板13
applet_girl14 img 女装模板14
applet_girl15 img 女装模板15
applet_girl16 img 女装模板16
applet_girl17 img 女装模板17
applet_kid1 img 童装模板1
applet_kid2 img 童装模板2
applet_kid3 img 童装模板3
applet_kid4 img 童装模板4
applet_kid5 img 童装模板5
applet_kid6 img 童装模板6
applet_kid7 img 童装模板7
applet_kid8 img 童装模板8
applet_kid9 img 童装模板9
applet_kid10 img 童装模板10
applet_kid11 img 童装模板11
applet_kid12 img 童装模板12
applet_kid13 img 童装模板13
applet_kid14 img 童装模板14
applet_kid15 img 童装模板15
applet_kid16 img 童装模板16
applet_kid17 img 童装模板17
applet_kid18 img 童装模板18
applet_kid19 img 童装模板19
applet_kid20 img 童装模板20
applet_kid21 img 童装模板21
applet_kid22 img 童装模板22
applet_kid23 img 童装模板23