本文档为您介绍五官分割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小时后会被系统自动清理删除。