本文介绍头像分割SegmentHead的语法及示例。
功能说明
头像分割用于识别图片中的人物头像,并对人物头像进行抠图解析,最后输出PNG格式的人物头像透明图。
应用场景
- 创意平面设计:从已获授权的真人照片中分割出头像部分,整合到卡通类画面上,可创作出平面广告,招贴画等。
- 视频制作:将自己的头像从生活照中抠出,贴到视频素材中,生成一段搞笑幽默的短视频。
特点优势
- 仅包含人脸头像:精确抠出人脸头发部分,不包含脖子等其他部分。
- 精准分割头发部分:对于细碎的头发也能精准从背景中抠出。
前提条件
图片限制
- 图片格式:JPEG、JPG、PNG、BMP。
- 图像大小:不超过3M。
- 图像分辨率:大于32×32像素,小于2000×2000像素。
- URL地址不能包含中文字符。
计费说明
关于头像分割的计费方式及报价,请参见计费介绍。
说明 下方调试接口为付费接口,如需免费体验调试请前往体验中心。
调试
您可以在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地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
ReturnForm | String | 否 | mask |
指定返回的图像形式。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
Elements | Array of Element |
各个子元素的抠图结果。 |
|
Height | Integer | 180 |
结果图的高度。 |
ImageURL | String | http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-6-2/invi_headsegmenter_015910809094981099086_TAamhR.png?Expires=1591082709&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=xuUE%2FbYeB9LpR18VXawOVeutQU**** |
结果图像URL地址,有效期30分钟。 |
Width | Integer | 116 |
结果图的宽度。 |
X | Integer | 445 |
左上角x坐标。 |
Y | Integer | 102 |
左上角y坐标。 |
RequestId | String | 89BBDA42-E1CA-426E-9A46-C703D8DBB1E2 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=SegmentHead
&ImageURL=https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentHead/person.jpg
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>89BBDA42-E1CA-426E-9A46-C703D8DBB1E2</RequestId>
<Data>
<Elements>
<X>445</X>
<ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-6-2/invi_headsegmenter_015910809094981099086_TAamhR.png?Expires=1591082709&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=xuUE%2FbYeB9LpR18VXawOVeutQU****</ImageURL>
<Y>102</Y>
<Height>180</Height>
<Width>116</Width>
</Elements>
<Elements>
<X>222</X>
<ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-6-2/invi_headsegmenter_015910809096071099089_e0oCCM.png?Expires=1591082709&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=phcOQyNR0px4gjlM2F9WfG54nX****</ImageURL>
<Y>49</Y>
<Height>192</Height>
<Width>176</Width>
</Elements>
<Elements>
<X>86</X>
<ImageURL>http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-6-2/invi_headsegmenter_015910809097101099092_BijNs3.png?Expires=1591082709&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=EQ43v12hqR%2FZOI9d9r753GZTyX****</ImageURL>
<Y>44</Y>
<Height>181</Height>
<Width>123</Width>
</Elements>
</Data>
JSON
格式
{
"RequestId": "89BBDA42-E1CA-426E-9A46-C703D8DBB1E2",
"Data": {
"Elements": [
{
"X": 445,
"ImageURL": "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-6-2/invi_headsegmenter_015910809094981099086_TAamhR.png?Expires=1591082709&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=xuUE%2FbYeB9LpR18VXawOVeutQU****",
"Y": 102,
"Height": 180,
"Width": 116
},
{
"X": 222,
"ImageURL": "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-6-2/invi_headsegmenter_015910809096071099089_e0oCCM.png?Expires=1591082709&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=phcOQyNR0px4gjlM2F9WfG54nX****",
"Y": 49,
"Height": 192,
"Width": 176
},
{
"X": 86,
"ImageURL": "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_headsegmenter/2020-6-2/invi_headsegmenter_015910809097101099092_BijNs3.png?Expires=1591082709&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=EQ43v12hqR%2FZOI9d9r753GZTyX****",
"Y": 44,
"Height": 181,
"Width": 123
}
]
}
}
错误码
关于头像分割的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交