RecognizeExpression_视觉智能开放平台-人脸人体_API文档

功能描述

表情识别能力可以检测和识别图片中人脸的表情。表情种类为：neutral（中性）、happiness（高兴）、surprise（惊讶）、sadness（伤心）、anger（生气）、disgust（厌恶）、fear（害怕）、pouty（嘟嘴）、grimace（鬼脸）。 关于该接口功能的示例图如下：

• 输入原图
• 检测返回结果示意图

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

应用场景

• 面部识别场景：通过识别用户人脸面部表情，对面部的真实表情进行检测和控制。
• 表情识别场景：通过表情识别技术，来确定被识别对象的心理情绪理解。
• 互动娱乐场景：获取表情、情绪等人脸属性信息，实现特效相机等互动娱乐功能。

特色优势

• 支持识别多种表情：中性、高兴、惊讶、伤心、生气、厌恶、害怕、嘟嘴、鬼脸等 9 种情绪。
• 简单易用：可直接调用的 API 接口，服务简单易用，易被集成，兼容性强。
• 尊重客户隐私，图片上传 24 小时内删除，服务不留存客户图像。

接入指引

1. 注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。
2. 开通能力：请确保您已开通人脸人体服务，若未开通服务请立即开通。

3. 创建 AccessKey：请确保您已创建 AccessKey，如果您使用的是子账号 AccessKey，您需要给子账号赋予 AliyunVIAPIFullAccess 权限，具体操作，请参见 RAM 授权。
4. 在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及 SDK 依赖信息，也可以下载完整的工程。
5. 开发接入步骤：

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

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

• Web 前端直接调用
• 小程序场景下直接调用
• Android 端直接调用
• iOS 端直接调用

输入限制

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

计费说明

关于表情识别的计费方式及报价，请参见计费介绍。