半身照/全身照抠图

基本信息

请求类型: HTTP/HTTPS

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

请求方式:POST

数据类型:JSON

响应类型: JSON

接口状态: 启用

接口描述:

此接口可以进行完整的人体抠图,也可以通过设置裁剪参数来对人体进行粗略的裁剪, 多人脸也能正常抠图,不过只扣算法选中的第一张人脸。结果返回扣好图后的透明底图片。

若需要换背景可使用我们提供的本地换背景并保存的代码,目前支持语言:HTML 、微信小程序、安卓、iOS、python

下载地址

调用此接口不会增加调用次数 结果返回透明底色带水印的图片URL及其名称, 存储时间为 1 天 通过名字获取带水印图片不会增加已调用次数 (通过获取图片的api获取无水印图片或无水印已排版图片会增加 1 次调用次数) 同一个图片名称(包括单张和排版),如果需要再次获取,不会增加已调用次数

对应的app_key应用类型必须为半身照/全身照抠图

考虑到响应速度,图片请用上方获取OSS直传凭证上传文件后使用图片的云端路径访问

请求参数

参数名称 参数类型 是否可空 参数示例 参数说明
file string app/123.jpg 图片文件oss存储的key,见第十三个接口
app_key string   已申请的app_key
img_size list [926,617] 制作结果宽高(非特殊要求不要传)
need_resize bool False 是否需要缩放,img_size只是确定比例,但是不会缩放(默认不缩放,非特殊要求不要传)
head_height list [0.25, 0.50] 头高 与 照片高度的比例范围(非特殊要求不要传)
headtop_margin list [0.05, 0.10] 头顶部到照片上边框距离与照片高度的比例范围(非特殊要求不要传)

注:若想自定义裁剪,img_size、need_resize、head_height、headtop_margin四个参数必填,具体可咨询技术人员

响应参数

参数名称 类型 参数说明
code int 状态码(200为正常请求,401为传入的规格id不存在)
result object  
source_file str 原图的云端存储路径(使用此路径作为此接口请求中的file将大大提高效率)
img_wm_url str 带水印图片URL
file_name list 无水印图片名称

python请求示例:

# 同步请求
import requests, json
​
def cutout_pic():
    url = "http://apicall.id-photo-verify.com/api/cutout_pic"
​
    headers = {"Content-Type": "application/json"}
​
    data = {
        "app_key": "your app_key",
        "file": "图片云端路径",
    }
​
    data_json = json.dumps(data)
​
    res = requests.post(url, headers=headers, data=data_json)
​
    print(res.status_code)
    print(res.text)
				

返回示例

{
  "code": 200, 
  "result": {
    "file_name": "cutout9e3422a3271f1442b73502a137fcf2.png", 
    "img_wm_url": "https://...", 
    "source_file": "app/9e3422a3271f1442b73502a137fcf2.jpg"
  }
}