ParseFace_视觉智能开放平台-分割抠图_API文档-阿里云OpenAPI开发者门户

接口说明

功能描述

五官分割能力可以检测输入的人脸正面图像，对眼睛、鼻子、嘴进行像素级语义分割。

说明

您可以进入在线咨询获取在线人工帮助。

当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击立即试用对该能力进行更直观试用以及在线购买。
阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。

接入指引

注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。
开通能力：请确保您已开通分割抠图服务，若未开通服务请立即开通。
创建 AccessKey：请确保您已创建 AccessKey，如果您使用的是子账号 AccessKey，您需要给子账号赋予 AliyunVIAPIFullAccess 权限，具体操作，请参见 RAM 授权。
在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及 SDK 依赖信息，也可以下载完整的工程。
开发接入步骤：

在 SDK 总览中选择您要接入使用的 SDK 语言。
在对应语言的 SDK 文档中找到 AI 类目为分割抠图（imageseg）的 SDK 包进行安装。
参考文档中提供的示例代码进行适当修改后调用。

客户端直接调用：该能力常用的客户端调用方式包括以下几种。

输入限制

图像格式：JPG、JPEG 、PNG。
图像大小：不超过 4 MB。
图像分辨率：大于 100×100 像素，小于 2048×2048 像素，且宽高比在 0.5~2.0 之间。
图像中仅包含单个人脸，要求正面，无眼镜、帽子等遮挡物。人脸部分的面积大小至少在 100×100 像素，且人脸检测框至少是对应边长的 1/10。
URL 地址中不能包含中文字符。

计费说明

关于五官分割的计费方式及报价，请参见计费介绍。

说明下方调试接口为付费接口，如需免费体验调试请前往体验中心。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

viapi-imageseg:ParseFace		全部资源 *	无	无

请求参数

字段名称	字段详情
ImageURLstring	图像 URL 地址。推荐使用上海地域的 OSS 链接，对于文件在本地或者非上海地域 OSS 链接的情况，请参见文件 URL 处理。示例值:http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/ParseFace/ParseFace1.jpg参考取值来源: SegmentHair

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:D6C24839-91A7-41DA-B31F-98F08EF80CC0
Dataobject	返回的结果数据内容。

返回说明

抠图结果 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	是	下嘴唇的分割结果。

SDK 参考

阿里云视觉 AI 分割抠图类目下的五官分割能力推荐使用 SDK 调用，支持多种编程语言，调用时请选择 AI 类目为分割抠图（imageseg）的 SDK 包，文件参数通过 SDK 调用可支持本地文件及任意 URL，具体可参见 SDK 总览。

返回示例

变更历史

暂无变更历史