全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多

DetectFace人脸检测

更新时间:2018-05-14 15:25:53

描述

检测相片的人脸。

请求参数

名称 类型 是否必填 描述
Project String 项目名
Action String DetectFace
SrcUris String 相片源的存储位置,例如 OSS 资源”oss://bucket1/a.jpg” 。
支持批量文件传入,一次最多支持10张相片,以 JSON 字符串的方式表示,例如:
[
“oss://bucket1/1.jpg”,
“oss://bucket1/2.jpg”
]

返回参数

名称 类型 描述
RequestId String 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户
SrcUris String 相片源的存储位置, 以 JSON 字符串的方式表示,例如:
[
“oss://bucket1/1.jpg”
]
SuccessDetails Array 成功识别详细信息 SuccessDetail 数组
FailDetails Array 相片识别失败原因 FailDetail 的数组

数据类型SuccessDetail

名称 类型 描述
SrcUri String 相片源的存储位置
PhotoId String 相片 ID
Faces Array 被检测出且加入照片集的人脸 Face 数组, 如果没有检测出人脸则为空数组

数据类型FailDetail

名称 类型 描述
SrcUri String 相片源的存储位置
Reason String 失败原因

数据类型Face

名称 类型 描述
FaceId String 人脸 ID
FaceRectangle Object 人脸矩形框 FaceRectangle
FaceAttribute Object 人脸属性 FaceAttribute

数据类型FaceRectangle

名称 类型 描述
Top Integer 左上角纵坐标
Left Integer 左上角横坐标
Width Integer 宽度
Height Integer 高度

数据类型FaceAttribute

名称 类型 描述
Gender Object 性别 Gender
Age Object 年龄 Age
HeadPose Object 人脸头部姿势 HeadPose
Eyestatus Object 眼睛状态 EyeStatus
Blur Object 人脸模糊度 Blur
FaceQuality Object 人脸质量 FaceQuality

数据类型Gender

名称 类型 描述
Value String 性别,Male 代表男性,Female 代表女性

数据类型Age

名称 类型 描述
Value Integer 标识估计的年龄,为非负整数

数据类型HeadPose

名称 类型 描述
PitchAngle Float 抬头角度
RollAngle Float 旋转(平面旋转)角度
YawAngle Float 摇头角度

数据类型EyeStatus

名称 类型 描述
LeftEyeStatus Object 左眼状态 OneEyeStatus
每个对象包括多个字段,每个字段的值是一个浮点数,范围[0,100],
小数点后3位有效数字,所有字段总和等于100
RightEyeStatus Object 右眼状态 OneEyeStatus
每个对象包括多个字段,每个字段的值是一个浮点数,范围[0,100],
小数点后3位有效数字,所有字段总和等于100

数据类型OneEyeStatus

名称 类型 描述
NormalGlassEyeOpen Float 佩戴普通眼镜且睁眼的置信度
NoGlassEyeClose Float 不戴眼镜且闭眼的置信
Occlusion Float 眼睛被遮挡的置信度
NoGlassEyeOpen Float 不戴眼镜且睁眼的置信度
NormalGlassEyeClose Float 佩戴普通眼镜且闭眼的置信度
DarkGlasses Float 佩戴墨镜的置信度

数据类型Blur

名称 类型 描述
Blurness Object 模糊度 Blurness

数据类型Blurness

名称 类型 描述
Value Float 人脸模糊分析结果, 为浮点数,范围[0,100],
小数点后3位有效数字
Threshold Float 人脸模糊度辨识的阈值

数据类型FaceQuality

名称 类型 描述
Value Float 人脸的质量判断的分数,为浮点数,范围[0,100],
小数点后3位有效数字
Threshold Float 脸质量基本合格的一个阈值,
超过该阈值的人脸适合用于人脸比对

示例

请求示例

  1. POST https://imm.cn-shanghai.aliyuncs.com
  2. ?Action=DetectFace
  3. &Project=test
  4. &SrcUris=["oss://bucket1/A.jpg",,"oss://bucket1/B.jpg"]

成功返回示例

  1. {
  2. "RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF187514",
  3. "SrcUris": ["oss://bucket1/A.jpg"],
  4. "SuccFaces": [{
  5. "SrcUri": "oss://bucket1/A.jpg",
  6. "PhotoId": "42fb0d5bf81c5ac57c52344dddc3e7c9 ",
  7. "Faces": [
  8. {
  9. "FaceAttribute": {
  10. "Gender": {
  11. "Value": "Female"
  12. },
  13. "Age": {
  14. "Value": 21
  15. }
  16. "HeadPose": {
  17. "YawAngle": -26.625063,
  18. "PitchAngle": 12.921974,
  19. "RollAngle": 22.814377
  20. },
  21. "EyeStatus": {
  22. "LeftEyeStatus": {
  23. "NormalGlassEyeOpen": 0.062,
  24. "NoGlassEyeClose": 0,
  25. "Occlusion": 0,
  26. "NoGlassEyeOpen": 99.938,
  27. "NormalGlassEyeClose": 0,
  28. "DarkGlasses": 0
  29. },
  30. "RightEyeStatus": {
  31. "NormalGlassEyeOpen": 0.082,
  32. "NoGlassEyeClose": 0,
  33. "Occlusion": 0,
  34. "NoGlassEyeOpen": 99.918,
  35. "NormalGlassEyeClose": 0,
  36. "DarkGlasses": 0
  37. }
  38. },
  39. "Blur": {
  40. "Blurness": {
  41. "Threshold": 50,
  42. "Value": 0.395
  43. }
  44. },
  45. "FaceQuality": {
  46. "Threshold": 70.1,
  47. "Value": 89.062
  48. }
  49. },
  50. "FaceRectangle": {
  51. "Width": 140,
  52. "Top": 89,
  53. "Left": 104,
  54. "Height": 141
  55. },
  56. "FaceId": "ed319e807e039ae669a4d1af0922a0c8"
  57. }
  58. ]
  59. }],
  60. "FailDetail": [{
  61. "SrcUri": "oss://bucket1/B.jpg",
  62. "Reason": "PhotoSizeTooLarge"
  63. }]
  64. }
本文导读目录