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
    }]
  }
}

错误码

具体请参见常见错误码