表情识别 - 阿里云视觉智能开放平台

功能描述

表情识别能力可以检测和识别图片中人脸的表情。表情种类为：neutral（中性）、happiness（高兴）、surprise（惊讶）、sadness（伤心）、anger（生气）、disgust（厌恶）、fear（害怕）。

特色优势

支持识别多种表情：中性、高兴、惊讶、伤心、生气、厌恶、害怕等。

前提条件

请确保您已开通人脸人体服务，若未开通服务请立即开通。

说明本能力仅限企业认证用户开通。更多实名认证操作信息，请参见实名认证。

输入限制

图像格式：JPEG、JPG、BMP、PNG、TIF、PBM。
图像大小：不超过3 MB。
图片分辨率：大于5×5像素，小于2048×2048像素，人脸占比不低于64×64像素。
URL地址中不能包含中文字符。

说明当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见图片缩放。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	RecognizeExpression	系统规定参数。取值：RecognizeExpression。
ImageURL	String	是	http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeExpression/RecognizeExpression10.jpg	图像URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

返回数据


名称	类型	示例值	描述
RequestId	String	E1C4C576-1799-4079-A934-15BC406A54EF	请求ID。
Data	Object		返回的结果数据内容。
Elements	Array of Element		各个子元素的识别结果。
FaceRectangle	Object		人脸区域信息。
Top	Integer	41	以图像左上角为坐标原点，人脸区域左上角的y坐标。
Width	Integer	121	人脸区域的宽度。
Height	Integer	174	人脸区域的高度。
Left	Integer	196	以图像左上角为坐标原点，人脸区域左上角的x坐标。
Expression	String	surprise	表情类别。取值如下： neutral：中性 happiness：高兴 surprise：惊讶 sadness：伤心 anger：生气 disgust：厌恶 fear：害怕
FaceProbability	Float	0.99651491641998291	检测结果的概率，取值范围为0~1。

示例

请求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=RecognizeExpression
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeExpression/RecognizeExpression10.jpg
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>E1C4C576-1799-4079-A934-15BC406A54EF</RequestId>
<Data>
    <Elements>
        <Expression>surprise</Expression>
        <FaceRectangle>
            <Left>196</Left>
            <Top>41</Top>
            <Height>174</Height>
            <Width>121</Width>
        </FaceRectangle>
        <FaceProbability>0.99651491641998291</FaceProbability>
    </Elements>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "E1C4C576-1799-4079-A934-15BC406A54EF",
  "Data" : {
    "Elements" : [ {
      "Expression" : "surprise",
      "FaceRectangle" : {
        "Left" : 196,
        "Top" : 41,
        "Height" : 174,
        "Width" : 121
      },
      "FaceProbability" : "0.99651491641998291"
    } ]
  }
}

错误码

关于表情识别的错误码，详情请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

请确保上传的图片或文件来源符合相应的法律法规。
通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。