SegmentHair用于识别图片中的人物头像,然后对人物头像区域进行抠图解析,最后输出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 SegmentHair

系统规定参数。取值:SegmentHair。

ImageURL String https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentHair/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/face1.png

抠图结果(png透明图)有效期30分钟。

X Integer 446

左上角x坐标。

Y Integer 102

左上角y坐标。

Width Integer 113

抠图结果图的宽度。

Height Integer 180

抠图结果图的高度。

示例

请求示例

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

正常返回示例

JSON 格式

{
  "RequestId": "D6C24839-91A7-41DA-B31F-98F08EF80CC0",
  "Data": {
    "Elements": [{
      "Height": 180,
      "ImageURL": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face1.png",
      "Width": 113,
      "X": 446,
      "Y": 102
    }, {
      "Height": 192,
      "ImageURL": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face2.png",
      "Width": 177,
      "X": 220,
      "Y": 49
    }, {
      "Height": 181,
      "ImageURL": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face3.png",
      "Width": 123,
      "X": 86,
      "Y": 44
    }]
  }
}

错误码

具体请参见常见错误码