本文档为您介绍五官分割ParseFace的语法及示例。
功能描述
ParseFace可以检测输入的人脸正面图像,对眼睛、鼻子、嘴进行像素级语义分割。
前提条件
输入限制
- 图片格式:JPG、JPEG 、PNG。
- 图片分辨率:分辨率要求大于100×100,小于2048×2048,且宽高比在0.5~2.0之间。
- 图片大小:大小不超过4M。
- 图片中仅包含单个人脸,要求正面,无眼镜、帽子等遮挡物。人脸部分的面积大小至少在100×100,且人脸检测框至少是对应边长的1/10。
- URL地址中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ParseFace |
要执行的操作。取值:ParseFace。 |
ImageURL | String | 是 | https://vigen-invi.oss-cn-shanghai.aliyuncs.com/temp/faceparsing/example.jpg |
图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
Elements | Array of Element |
各个子元素的分割结果。 |
|
ImageURL | String | oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751202611000042_EBPBLN.png |
抠图结果,有效期半个小时。 |
Name | String | skin |
抠图结果key值。具体请参见下面表格说明。 |
OriginImageURL | String | https://vigen-invi.oss-cn-shanghai.aliyuncs.com/temp/faceparsing/example.jpg |
原始图片URL地址。 |
RequestId | String | D6C24839-91A7-41DA-B31F-98F08EF80CC0 |
请求ID。 |
抠图结果key值说明。
name值 |
类型 |
是否必须 |
描述 |
---|---|---|---|
skin |
string |
是 |
脸部皮肤的分割结果。 |
l_brow |
string |
是 |
左眉毛的分割结果。 |
r_brow |
string |
是 |
右眉毛的分割结果。 |
l_eye |
string |
是 |
左眼睛的分割结果。 |
r_eye |
string |
是 |
右眼睛的分割结果。 |
nose |
string |
是 |
鼻子的分割结果。 |
l_ear |
string |
否 |
左耳的分割结果。 |
r_ear |
string |
否 |
右耳的分割结果。 |
mouth |
string |
否 |
上下嘴唇中间部分的分割结果。若人物为闭嘴状态,则不会输出。 |
u_lip |
string |
是 |
上嘴唇的分割结果。 |
l_lip |
string |
是 |
下嘴唇的分割结果。 |
示例
请求示例
http(s)://imageseg.cn-shanghai.aliyuncs.com/?Action=ParseFace
&ImageURL=https://vigen-invi.oss-cn-shanghai.aliyuncs.com/temp/faceparsing/example.jpg
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>D6C24839-91A7-41DA-B31F-98F08EF80CC0</RequestId>
<Data>
<OriginImageURL>https://vigen-invi.oss-cn-shanghai.aliyuncs.com/temp/faceparsing/example.jpg</OriginImageURL>
<Elements>
<Name>skin</Name>
<ImageURL>oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751202611000042_EBPBLN.png</ImageURL>
</Elements>
<Elements>
<Name>l_brow</Name>
<ImageURL>oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751204181000049_fTTYNi.png</ImageURL>
</Elements>
<Elements>
<Name>r_brow</Name>
<ImageURL>oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751205391000051_ydEwL5.png</ImageURL>
</Elements>
<Elements>
<Name>l_eye</Name>
<ImageURL>oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751206401000054_m6dPH2.png</ImageURL>
</Elements>
<Elements>
<Name>r_eye</Name>
<ImageURL>oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751207281000055_nH722a.png</ImageURL>
</Elements>
<Elements>
<Name>l_ear</Name>
<ImageURL>oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi__015814751202771000044_xzaQjz.png</ImageURL>
</Elements>
<Elements>
<Name>r_ear</Name>
<ImageURL>oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi__015814751203891000047_e9cPUx.png</ImageURL>
</Elements>
<Elements>
<Name>nose</Name>
<ImageURL>oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi__015814751204921000050_1mGUOK.png</ImageURL>
</Elements>
<Elements>
<Name>u_lip</Name>
<ImageURL>oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi__015814751202751000043_tIPX7W.png</ImageURL>
</Elements>
<Elements>
<Name>l_lip</Name>
<ImageURL>oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi__015814751203701000046_K8aiYg.png</ImageURL>
</Elements>
</Data>
JSON
格式
{
"RequestId": "D6C24839-91A7-41DA-B31F-98F08EF80CC0",
"Data": {
"OriginImageURL": "https://vigen-invi.oss-cn-shanghai.aliyuncs.com/temp/faceparsing/example.jpg",
"Elements": [{
"Name": "skin",
"ImageURL": "oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751202611000042_EBPBLN.png"
},
{
"Name": "l_brow",
"ImageURL": "oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751204181000049_fTTYNi.png"
},
{
"Name": "r_brow",
"ImageURL": "oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751205391000051_ydEwL5.png"
},
{
"Name": "l_eye",
"ImageURL": "oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751206401000054_m6dPH2.png"
},
{
"Name": "r_eye",
"ImageURL": "oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi_builder_015814751207281000055_nH722a.png"
},
{
"Name": "l_ear",
"ImageURL": "oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi__015814751202771000044_xzaQjz.png"
},
{
"Name": "r_ear",
"ImageURL": "oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi__015814751203891000047_e9cPUx.png"
},
{
"Name": "nose",
"ImageURL": "oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi__015814751204921000050_1mGUOK.png"
},
{
"Name": "u_lip",
"ImageURL": "oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi__015814751202751000043_tIPX7W.png"
},
{
"Name": "l_lip",
"ImageURL": "oss://viapi-cn-shanghai-dha-segmenter/upload/fivesensesegmenter-2020-02-11-19-58-42-cd987d5f8-jxqn4/2020-2-12/invi__015814751203701000046_K8aiYg.png"
}
]
}
}
错误码
关于五官分割的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交