本文档为您介绍五官分割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

各个子元素的分割结果。
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"
			}
		]

	}
}

错误码

关于五官分割的错误码，详情请参见常见错误码。