基本信息

请求类型: 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]	头顶部到照片上边框距离与照片高度的比例范围(非特殊要求不要传)
self_wm	int	是	1	是否需要使用自定义水印，为1时表示需要使用自定义水印，需要使用自定义水印请联系我们
out_endpoint	string	是	https://oss-accelerate.aliyuncs.com	控制返回链接的域名，见参数说明7

注：若想自定义裁剪，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"
  }
}