concept-people-detection.md

title	titleSuffix	description	author	manager	ms.service	ms.topic	ms.date	ms.author
People detection - Azure AI Vision	Azure AI services	Learn concepts related to the people detection feature of the Azure AI Vision API - usage and limits.	PatrickFarley	nitinme	azure-ai-vision	conceptual	01/22/2025	pafarley

People detection (version 4.0)

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 doesn't 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.

{
  "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 step

[!div class="nextstepaction"] Call the Analyze Image API