SegmentFace用于识别图片中的人物头像，然后对人物头像区域进行抠图解析，最后输出png格式的人物面部透明图。

图片限制

  • 图片格式：JPEG、JPG、PNG（不支持gif以及8位、16位、64位的png）、BMP、WEBP。
  • 图像大小：小于3M。
  • 图像分辨率：最小边小于等于2000像素，最大边大于等于32像素且小于等于8000像素，像素点数小于800万（即图像宽乘高小于800万），同时长边与短边的像素比例小于等于16。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SegmentFace

系统规定参数。取值：SegmentFace。
ImageURL String 是 https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/person.jpg

图片url地址。

返回数据

名称 类型 示例值 描述
RequestId String D6C24839-91A7-41DA-B31F-98F08EF80CC0

当前请求的request id。
Data Struct

返回的数据内容。
Elements Array

各个子元素的抠图结果。
ImageURL String https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face.png

抠图结果（png透明图），有效期30分钟。
X Integer 444

左上角x坐标。
Y Integer 119

左上角y坐标。
Width Integer 74

抠图结果图的宽度。
Height Integer 86

抠图结果图的高度。

示例

请求示例

https://imageseg.cn-shanghai.aliyuncs.com/?Action=SegmentFace&<公共请求参数>

正常返回示例

JSON 格式 

{
  "RequestId": "D6C24839-91A7-41DA-B31F-98F08EF80CC0",
  "Data": {
    "ImageURL": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face.png",
    "Elements": [{
      "Height": 86,
      "ImageURL": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face1.png",
      "Width": 74,
      "X": 444,
      "Y": 119
    }, {
      "H": 79,
      "ImageURL": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face2.png",
      "Width": 58,
      "X": 294,
      "Y": 86
    }, {
      "H": 78,
      "ImageURL": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face3.png",
      "Width": 61,
      "X": 125,
      "Y": 69
    }]
  }
}

错误码

具体请参见常见错误码。