Edit

People detection (version 4.0)

  • Article

Version 4.0 of Image Analysis offers the ability to detect people appearing in images. The bounding box coordinates of each detected person are returned, along with a confidence score.

Important

We built this model by enhancing our object detection model for person detection scenarios. People detection does not involve distinguishing one face from another face, predicting or classifying facial attributes, or creating a facial template (a unique set of numbers generated from an image that represents the distinctive features of a face).

People detection example

The following JSON response illustrates what the Analysis 4.0 API returns when describing the example image based on its visual features.

Photo of four people.

{
  "modelVersion": "2024-02-01",
  "metadata": {
    "width": 300,
    "height": 231
  },
  "peopleResult": {
    "values": [
      {
        "boundingBox": {
          "x": 0,
          "y": 41,
          "w": 95,
          "h": 189
        },
        "confidence": 0.9474349617958069
      },
      {
        "boundingBox": {
          "x": 204,
          "y": 96,
          "w": 95,
          "h": 134
        },
        "confidence": 0.9470965266227722
      },
      {
        "boundingBox": {
          "x": 53,
          "y": 20,
          "w": 136,
          "h": 210
        },
        "confidence": 0.8943784832954407
      },
      {
        "boundingBox": {
          "x": 170,
          "y": 31,
          "w": 91,
          "h": 199
        },
        "confidence": 0.2713555097579956
      }
    ]
  }
}

Use the API

The people detection feature is part of the Analyze Image 4.0 API. Include People in the features query parameter. Then, when you get the full JSON response, parse the string for the contents of the "people" section.

Next steps