Face detection with Computer Vision
Computer Vision can detect human faces within an image and generate the age, gender, and rectangle for each detected face.
Note
This feature is also offered by the Azure Face service. See this alternative for more detailed face analysis, including face identification and pose detection.
Face detection examples
The following example demonstrates the JSON response returned by Computer Vision for an image containing a single human face.
{
"faces": [
{
"age": 23,
"gender": "Female",
"faceRectangle": {
"top": 45,
"left": 194,
"width": 44,
"height": 44
}
}
],
"requestId": "8439ba87-de65-441b-a0f1-c85913157ecd",
"metadata": {
"height": 200,
"width": 300,
"format": "Png"
}
}
The next example demonstrates the JSON response returned for an image containing multiple human faces.
{
"faces": [
{
"age": 11,
"gender": "Male",
"faceRectangle": {
"top": 62,
"left": 22,
"width": 45,
"height": 45
}
},
{
"age": 11,
"gender": "Female",
"faceRectangle": {
"top": 127,
"left": 240,
"width": 42,
"height": 42
}
},
{
"age": 37,
"gender": "Female",
"faceRectangle": {
"top": 55,
"left": 200,
"width": 41,
"height": 41
}
},
{
"age": 41,
"gender": "Male",
"faceRectangle": {
"top": 45,
"left": 103,
"width": 39,
"height": 39
}
}
],
"requestId": "3a383cbe-1a05-4104-9ce7-1b5cf352b239",
"metadata": {
"height": 230,
"width": 300,
"format": "Png"
}
}
Use the API
The face detection feature is part of the Analyze Image API. You can call this API through a native SDK or through REST calls. Include Faces
in the visualFeatures query parameter. Then, when you get the full JSON response, simply parse the string for the contents of the "faces"
section.