本文档介绍头发分割SegmentHair的语法及示例。
功能描述
头发分割用于识别图片中的人物头像,然后对人物头像区域进行抠图解析,最后输出PNG格式的人物头发矩形透明图。
应用场景
- 假发网络试戴:通过头发分割,截取自拍照的头发后,换成假发图像,就可以直接看到假发试戴效果,省去了网购后佩戴不合适需要退换货的烦恼。
- 理发店发型尝试:发型师指导客户通过平板电脑或手机拍摄的自己头像,换成各种发型,有更直观的感觉。客户可以选择最喜欢的发型,让发型师为自己打理。
特色优势
发丝边缘的精确分割:对发丝边缘可以精确分割,分割后图像编辑结果无违和感。
前提条件
输入限制
- 图片格式:JPEG、JPG、PNG、BMP。
- 图像大小:不超过3M。
- 图像分辨率:大于32×32像素,小于2000×2000像素。
- 图片URL地址中不能包含中文字符。
调试
您可以在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地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
Elements | Array of Element |
各个子元素的抠图结果。 |
|
Height | Integer | 180 |
结果图的高度。 |
ImageURL | String | https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face1.png |
结果图像URL地址,有效期30分钟。 |
Width | Integer | 113 |
结果图的宽度。 |
X | Integer | 446 |
结果图左上角在原图中的x轴坐标。 |
Y | Integer | 102 |
结果图左上角在原图中的y轴坐标。 |
RequestId | String | D6C24839-91A7-41DA-B31F-98F08EF80CC0 |
请求ID。 |
示例
请求示例
http(s)://imageseg.cn-shanghai.aliyuncs.com/?Action=SegmentHair
&ImageURL=https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentHair/person.jpg
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>D6C24839-91A7-41DA-B31F-98F08EF80CC0</RequestId>
<Data>
<Elements>
<Height>180</Height>
<ImageURL>https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face1.png</ImageURL>
<Width>113</Width>
<X>446</X>
<Y>102</Y>
</Elements>
<Elements>
<Height>192</Height>
<ImageURL>https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face2.png</ImageURL>
<Width>177</Width>
<X>220</X>
<Y>49</Y>
</Elements>
<Elements>
<Height>181</Height>
<ImageURL>https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentFace/face3.png</ImageURL>
<Width>123</Width>
<X>86</X>
<Y>44</Y>
</Elements>
</Data>
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
}]
}
}
错误码
关于头发分割的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交