本文档介绍面部分割SegmentFace的语法及示例。
功能描述
SegmentFace用于识别图片中的人物头像,然后对人物头像区域进行抠图解析,最后输出PNG格式的人物面部透明图。
前提条件
输入限制
- 图片格式:JPEG、JPG、PNG、BMP。
- 图像大小:图像大小不超过3M。
- 图像分辨率:分辨率要求大于32×32像素,小于2000×2000像素。
- 图片URL地址中不能包含中文字符。
调试
您可以在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地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
Elements | Array of Element |
各个子元素的抠图结果。 |
|
Height | Integer | 86 |
结果图的高度。 |
ImageURL | String | https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face.png |
结果图像URL地址,有效期30分钟。 |
Width | Integer | 74 |
结果图的宽度。 |
X | Integer | 444 |
左上角x坐标。 |
Y | Integer | 119 |
左上角y坐标。 |
RequestId | String | 37504009-E4CA-48DB-A8A9-338C7758882B |
请求ID。 |
示例
请求示例
http(s)://imageseg.cn-shanghai.aliyuncs.com/?Action=SegmentFace
&ImageURL=https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/person.jpg
&<公共请求参数>
正常返回示例
XML
格式
<Data>
<Elements>
<ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-2-21/invi_headsegmenter_015822650467671000637_cPSZPO.png?Expires=1582266846&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=95QFAjq34E0rO7Cf0wRqd%2BHOib****</ImageURL>
<Height>189</Height>
<Width>128</Width>
<Y>179</Y>
<X>254</X>
</Elements>
<Elements>
<ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-2-21/invi_headsegmenter_015822650468961000640_vP2y1L.png?Expires=1582266846&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=BWaHssIEvRYcCEOOX%2FJmk8%2FtwJ****</ImageURL>
<Height>102</Height>
<Width>85</Width>
<Y>39</Y>
<X>215</X>
</Elements>
</Data>
<RequestId>37504009-E4CA-48DB-A8A9-338C7758882B</RequestId>
JSON
格式
{
"Data": {
"Elements": [
{
"ImageURL": "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-2-21/invi_headsegmenter_015822650467671000637_cPSZPO.png?Expires=1582266846&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=95QFAjq34E0rO7Cf0wRqd%2BHOib****",
"Height": 189,
"Width": 128,
"Y": 179,
"X": 254
},
{
"ImageURL": "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-2-21/invi_headsegmenter_015822650468961000640_vP2y1L.png?Expires=1582266846&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=BWaHssIEvRYcCEOOX%2FJmk8%2FtwJ****",
"Height": 102,
"Width": 85,
"Y": 39,
"X": 215
}
]
},
"RequestId": "37504009-E4CA-48DB-A8A9-338C7758882B"
}
错误码
关于面部分割的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交