接口说明
功能描述
人脸属性识别能力可以识别检测人脸的性别、年龄、表情、眼镜、帽子五种属性,支持人脸遮挡、光照、模糊度、姿态、噪声综合质量评分,支持检测含有多张人脸的照片属性判断。
- 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击立即试用对该能力进行更直观试用以及在线购买。
- 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。
特色优势
- 适应能力强:不同照片、人脸尺寸多场景下,覆盖多个年龄段识别。
- 图片质量打分:支持人脸遮挡、光照、模糊度、姿态、噪声综合质量评分。
- 平台服务稳定:提供在高并发,大流量下的毫秒级识别响应和保障。
接入指引
- 创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权。
- 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。
- 开发接入步骤:
- 在 SDK 总览中选择您要接入使用的 SDK 语言。
- 在对应语言的 SDK 文档中找到 AI 类目为人脸人体(facebody)的 SDK 包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
- 示例代码:该能力常用语言的示例代码,请参见人脸属性识别示例代码。
- 客户端直接调用:该能力常用的客户端调用方式包括以下几种。
输入限制
- 图像格式:JPEG、JPG、PNG、BMP。
- 图像大小:不超过 20 MB。
- 图像分辨率:大于 32×32 像素,小于 4096×4096 像素,人脸占比不低于 64×64 像素。
- URL 地址中不能包含中文字符。
计费说明
关于人脸属性识别的计费方式及报价,请参见计费介绍。
流控信息
请求参数
字段名称 | 字段详情 |
---|---|
ImageURLstring | |
Ageboolean | 兼容老版本接口,用来控制是否需要返回人脸年龄结果,取值 true 或 false,默认 false。 示例值:false |
Genderboolean | 兼容老版本接口,用来控制是否需要返回人脸性别结果,取值 true 或 false,默认 false。 示例值:false |
Hatboolean | 兼容老版本接口,用来控制是否需要返回人脸帽子结果,取值 true 或 false,默认 false。 示例值:false |
Glassboolean | 兼容老版本接口,用来控制是否需要返回人脸眼镜结果,取值 true 或 false,默认 false。 示例值:false |
Beautyboolean | 兼容老版本接口,用来控制是否需要返回人脸颜值结果,取值 true 或 false,默认 false。 示例值:false |
Expressionboolean | 兼容老版本接口,用来控制是否需要返回人脸表情结果,取值 true 或 false,默认 false。 示例值:false |
Maskboolean | 兼容老版本接口,用来控制是否需要返回人脸口罩结果,取值 true 或 false,默认 false。 示例值:false |
Qualityboolean | 兼容老版本接口,用来控制是否需要返回人脸质量,取值 true 或 false,默认 false。 示例值:false |
MaxFaceNumberinteger<int64> | 兼容老版本接口,用来设置图片中人脸的最大返回数量,取值范围 1~10,默认为 1。若想返回多个人脸检测结果,请正确设置。默认按返回参数 FaceProbabilityList 进行降序排列。 注意
该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。 示例值:1 |
返回参数
字段名称 | 字段详情 |
---|---|
RequestIdstring | 请求 ID。 示例值:8251C88E-8273-4DBF-94FB-A6BCB268CEA2 |
Dataobject | 返回的结果数据内容。 |
返回说明
SDK 参考
阿里云视觉 AI 人脸人体类目下的人脸属性识别能力推荐使用 SDK 调用,支持多种编程语言,调用时请选择 AI 类目为人脸人体(facebody)的 SDK 包,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览。
示例代码
该能力常用语言的示例代码,请参见人脸属性识别示例代码。
返回示例
错误码
变更历史
变更时间 | 变更内容概要 | 操作 | |
---|---|---|---|
2021-04-29 |