post/api/ai/images/v2/face-detection

Request

Request body multipart/form-data

imagestring binary

The image file for face detection

Response

Success

idstring

The unique identifier associated with the face detection process.

statusstring

The status of the face detection process.

timestampinteger

The timestamp when the face detection request was processed.

processing_countinteger

The number of times the image has been processed for face detection.

Example response

{
  "id": "2968b2d5-5eae-40ba-8aac-935521a84b77",
  "status": "success",
  "timestamp": 1687839745335,
  "analysed_data": [
    {
      "bounding_box": {
        "width": 0.10777401179075241,
        "height": 0.13282546401023865,
        "left": 0.17654450237751007,
        "top": 0.3921668529510498
      },
      "age_range": {
        "low": 20,
        "high": 28
      },
      "smile": {
        "value": false,
        "confidence": 93.70523071289062
      },
      "eyeglasses": {
        "value": true,
        "confidence": 99.99999237060547
      },
      "sunglasses": {
        "value": false,
        "confidence": 99.95690155029297
      },
      "gender": {
        "value": "Male",
        "confidence": 99.96484375
      },
      "beard": {
        "value": false,
        "confidence": 62.05418014526367
      },
      "mustache": {
        "value": false,
        "confidence": 97.35452270507812
      },
      "eyes_open": {
        "value": true,
        "confidence": 98.76431274414062
      },
      "mouth_open": {
        "value": true,
        "confidence": 84.85880279541016
      },
      "emotions": [
        {
          "type": "SURPRISED",
          "confidence": 92.99723815917969
        },
        {
          "type": "CALM",
          "confidence": 23.0799503326416
        },
        {
          "type": "FEAR",
          "confidence": 7.924409866333008
        },
        {
          "type": "CONFUSED",
          "confidence": 4.7363104820251465
        },
        {
          "type": "SAD",
          "confidence": 2.6062285900115967
        },
        {
          "type": "ANGRY",
          "confidence": 1.7453320026397705
        },
        {
          "type": "HAPPY",
          "confidence": 1.4428735971450806
        },
        {
          "type": "DISGUSTED",
          "confidence": 1.3754680156707764
        }
      ],
      "landmarks": [
        {
          "type": "eyeLeft",
          "x": 0.21465006470680237,
          "y": 0.437491774559021
        },
        {
          "type": "eyeRight",
          "x": 0.25979283452033997,
          "y": 0.4359549283981323
        },
        {
          "type": "mouthLeft",
          "x": 0.22244024276733398,
          "y": 0.48688557744026184
        },
        {
          "type": "mouthRight",
          "x": 0.2600334584712982,
          "y": 0.4855155050754547
        },
        {
          "type": "nose",
          "x": 0.2459861785173416,
          "y": 0.4550646245479584
        },
        {
          "type": "leftEyeBrowLeft",
          "x": 0.19446563720703125,
          "y": 0.4297780692577362
        },
        {
          "type": "leftEyeBrowRight",
          "x": 0.22514291107654572,
          "y": 0.4198493957519531
        },
        {
          "type": "leftEyeBrowUp",
          "x": 0.21060246229171753,
          "y": 0.4192149043083191
        },
        {
          "type": "rightEyeBrowLeft",
          "x": 0.25112780928611755,
          "y": 0.4189653992652893
        },
        {
          "type": "rightEyeBrowRight",
          "x": 0.2729511260986328,
          "y": 0.42690983414649963
        },
        {
          "type": "rightEyeBrowUp",
          "x": 0.2628464102745056,
          "y": 0.41738104820251465
        },
        {
          "type": "leftEyeLeft",
          "x": 0.2056843489408493,
          "y": 0.43866878747940063
        },
        {
          "type": "leftEyeRight",
          "x": 0.2234984040260315,
          "y": 0.43773695826530457
        },
        {
          "type": "leftEyeUp",
          "x": 0.21461336314678192,
          "y": 0.4346442222595215
        },
        {
          "type": "leftEyeDown",
          "x": 0.21498507261276245,
          "y": 0.439727783203125
        },
        {
          "type": "rightEyeLeft",
          "x": 0.250782310962677,
          "y": 0.4368106424808502
        },
        {
          "type": "rightEyeRight",
          "x": 0.2668272852897644,
          "y": 0.43646448850631714
        },
        {
          "type": "rightEyeUp",
          "x": 0.25996148586273193,
          "y": 0.43306758999824524
        },
        {
          "type": "rightEyeDown",
          "x": 0.25965967774391174,
          "y": 0.4381241202354431
        },
        {
          "type": "noseLeft",
          "x": 0.23344972729682922,
          "y": 0.4658816158771515
        },
        {
          "type": "noseRight",
          "x": 0.25016430020332336,
          "y": 0.46519964933395386
        },
        {
          "type": "mouthUp",
          "x": 0.2432977706193924,
          "y": 0.47654277086257935
        },
        {
          "type": "mouthDown",
          "x": 0.24340258538722992,
          "y": 0.4926367402076721
        },
        {
          "type": "leftPupil",
          "x": 0.21465006470680237,
          "y": 0.437491774559021
        },
        {
          "type": "rightPupil",
          "x": 0.25979283452033997,
          "y": 0.4359549283981323
        },
        {
          "type": "upperJawlineLeft",
          "x": 0.1773587167263031,
          "y": 0.45201900601387024
        },
        {
          "type": "midJawlineLeft",
          "x": 0.19171585142612457,
          "y": 0.5035356879234314
        },
        {
          "type": "chinBottom",
          "x": 0.24220940470695496,
          "y": 0.5216568112373352
        },
        {
          "type": "midJawlineRight",
          "x": 0.2716551721096039,
          "y": 0.500251829624176
        },
        {
          "type": "upperJawlineRight",
          "x": 0.27593758702278137,
          "y": 0.4482903778553009
        }
      ],
      "pose": {
        "roll": 0.020759621381878854,
        "yaw": 0.12492620903205871,
        "pitch": -0.23875144135951995
      },
      "quality": {
        "brightness": 0.85,
        "sharpness": 0.92
      },
      "confidence": 0.97
    }
  ],
  "processing_count": 3
}

Changes

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      endpoint added