imgix APIs
Rendering API
Face Detection
JSON Face Data

JSON Face Data

faces

The faces parameter is a flag that forces the fm=json parameter to include face data.

When faces=1, coordinate data for the bounds, mouth, left eye, and right eye of each face will be added to the JSON output. The coordinates start on the top left corner of the image.

Original
sandbox-demo

faces=1&fm=json

{
  "Faces":[
    {
      "bounds": {
        "y": 273,
        "x": 326,
        "height": 168,
        "width": 168
      },
      "mouth": {
        "y": 230,
        "x": 402
      },
      "right_eye": {
        "y": 159,
        "x": 426
      },
      "left_eye": {
        "y": 150,
        "x": 397
      }
    },
    {
      "bounds": {
        "y": 356,
        "x": 460,
        "height": 146,
        "width": 146
      },
      "mouth": {
        "y": 310,
        "x": 556
      },
      "right_eye": {
        "y": 239,
        "x": 536
      },
      "left_eye": {
        "y": 284,
        "x": 496
      }
    }
  ],
  "JFIF": {
    "DensityUnit": 1,
    "YDensity": 72,
    "JFIFVersion": [
      1,
      1
    ],
    "XDensity": 72
  },
  "ColorModel": "RGB",
  "Depth": 8,
  "ProfileName": "sRGB IEC61966-2.1",
  "PixelHeight": 533,
  "PixelWidth": 800,
  "DPIWidth": 72,
  "DPIHeight": 72
}
Face PaddingFill