Rendering API
Face Index faceindex
The faceindex parameter selects a face on which to center an image when fit=facearea.
The faceindex parameter must be an integer. It can be set to any value from 1 to N, where N is the total number of detected faces in the image.
You can use faces parameter along with the fm=json parameter to determine how many faces are in the image.
{
"Content-Length": "350176",
"Content-Type": "image/jpeg",
"Orientation": 0,
"Faces": [
{
"bounds": {
"y": 105,
"x": 330,
"height": 166.25,
"width": 141.25
},
"confidence": 89
},
{
"bounds": {
"y": 196.25,
"x": 455,
"height": 147.5,
"width": 130
},
"confidence": 88
}
],
"PixelHeight": 533,
"PixelWidth": 800,
"Output": {},
"ProfileName": "sRGB IEC61966-2.1"
}See the API specification for more information about this parameter's value ranges and format.