SegmentHead用于识别图片中的人物头像，并对人物头像进行抠图解析，最后输出png格式的人物头像透明图。

图片限制

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

调试

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

请求参数

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

系统规定参数。取值：SegmentHead。
ImageURL String 是 https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentHead/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/SegmentHead/head1.png

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

左上角x坐标。
Y Integer 102

左上角y坐标。
Width Integer 115

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

抠图结果图的高度。

示例

请求示例

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

正常返回示例

JSON 格式 

{
  "RequestId": "D6C24839-91A7-41DA-B31F-98F08EF80CC0",
  "Data": {
    "Elements": [{
      "Height": 180,
      "ImageURL": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentHead/head1.png",
      "Width": 115,
      "X": 444,
      "Y": 102
    }, {
      "Height": 192,
      "ImageURL": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentHead/head2.png",
      "Width": 177,
      "X": 220,
      "Y": 49
    }, {
      "Height": 181,
      "ImageURL": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentHead/head3.png",
      "Width": 123,
      "X": 86,
      "Y": 44
    }]
  }
}

错误码

具体请参见常见错误码。