DetectImageFaces 人脸检测分析_图片管理类操作_API手册

描述

传入一张图片，检测其中的人脸。该功能不依赖媒体集 Set 。

请求参数

Parameter	Type	Required	Comment
Project	string	Y	Project
ImageUri	string	Y	图片 OSS URI，如 `oss://imm-test/testcases/test.jpg` OSS 地址规则为：`oss://bucket/object`，其中 `bucket` 为和当前 Project 在同一区域的 OSS 桶名， `object` 为文件路径。

返回参数

Parameter	Type	Comment
RequestId	string	该次请求的唯一识别码。
Faces	[]Face	人脸列表
ImageUri	string	图片 URI

示例

请求示例

POST https://imm.cn-shanghai.aliyuncs.com
?Action=DetectImageFaces
&Project=test-project
&ImageUri=oss://imm-test/testcases/test.jpg
...

此处的示例，目的是展示关键参数，还需要其他的公共参数才能正常调用，推荐使用 SDK 来发送 API。

成功返回示例

{
  "RequestId": "657DE4A1-AF37-4502-A463-E5D660E458C4",
  "Faces": [
    {
      "Age": 29,
      "GenderConfidence": 0.9999929070472717,
      "Attractive": 0.82,
      "EmotionDetails": {
        "SAD": 0.042472198605537415,
        "CALM": 0.01739625819027424,
        "ANGRY": 0.0007031452259980142,
        "HAPPY": 0.9365360140800476,
        "SCARED": 0.00042889462201856077,
        "DISGUSTED": 0.0006919803563505411,
        "SURPRISED": 0.00029711987008340657
      },
      "Gender": "MALE",
      "FaceConfidence": 0.9912033081054688,
      "Emotion": "HAPPY",
      "FaceId": "475c552af41187ddc593785bac3d05698aa95073857a501b160b130e73194221",
      "FaceAttributes": {
        "GlassesConfidence": 0.9999994039535522,
        "Glasses": "SUNGLASSES",
        "RaceConfidence": 0.9999100565910339,
        "Beard": "BEARD",
        "MaskConfidence": 1,
        "Race": "WHITE",
        "BeardConfidence": 0.9999916553497314,
        "FaceBoundary": {
          "Top": 58,
          "Height": 232,
          "Width": 233,
          "Left": 369
        },
        "Mask": "NONE"
      }
    },
    {
      "Age": 26,
      "GenderConfidence": 0.9999946355819702,
      "Attractive": 0.84,
      "EmotionDetails": {
        "SAD": 4.490751867591847e-11,
        "CALM": 0.0000013855681118002394,
        "ANGRY": 7.354262164527281e-12,
        "HAPPY": 0.9999986290931702,
        "SCARED": 3.7438101230247156e-11,
        "DISGUSTED": 4.075151674443056e-11,
        "SURPRISED": 1.5144473453077012e-9
      },
      "Gender": "FEMALE",
      "FaceConfidence": 0.9771245121955872,
      "Emotion": "HAPPY",
      "FaceId": "e95764db9598028b745ac61273aee5f580370fd1907f6409981753f5667cf303",
      "FaceAttributes": {
        "GlassesConfidence": 1,
        "Glasses": "SUNGLASSES",
        "RaceConfidence": 0.9999966621398926,
        "Beard": "NONE",
        "MaskConfidence": 1,
        "Race": "WHITE",
        "BeardConfidence": 1,
        "FaceBoundary": {
          "Top": 182,
          "Height": 166,
          "Width": 167,
          "Left": 159
        },
        "Mask": "NONE"
      }
    }
  ],
  "ImageUri": "oss://imm-test/testcases/test.jpg"
}

若在使用中有疑问，请参考 FAQ，或者进入钉钉用户群实时交流。