本文档为您介绍表情识别RecognizeExpression的语法及示例。

功能描述

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

示例图如下所示:

前提条件

请确保您已开通人脸人体服务,详情请参见服务开通

输入限制

  • 图片分辨率:分辨率要求大于5×5像素。
  • 图片大小:图片大小不超过3M。
  • 人脸尺寸:建议大于64×64像素。
  • URL地址中不能包含中文字符。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String RecognizeExpression

要执行的操作。取值:RecognizeExpression。

ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test/facebody/RecognizeBrow/brow.jpg

图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

Elements Array

各个子元素的识别结果。

Expression String surprise

表情类别。枚举类型:neutral、happiness、surprise、sadness、anger、disgust、fear。

FaceProbability Float 0.99651491641998291

检测结果的概率,取值范围为0~1。

FaceRectangle Struct

人脸区域信息。

Height Integer 174

人脸区域的高度。

Left Integer 196

人脸区域的左上角x坐标。

Top Integer 41

人脸区域的左上角y坐标。

Width Integer 121

人脸区域的宽度。

RequestId String E1C4C576-1799-4079-A934-15BC406A54EF

请求ID。

示例

请求示例

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

正常返回示例

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 格式

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

错误码

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