iLive Docs
API ReferenceFace Services

Detect Faces

Detect faces in an image and return their bounding boxes, landmarks, and attributes.

POST
/api/v2/faces:detect
/api/v2/faces:detect

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

multipart/form-dataRequired

image
Required
Image

JPEG or PNG image

Format: "binary"

attributesAttributes

Default: "default"
curl -X POST "https://docs.localhost:8543/api/v2/faces:detect" \
  -H "Authorization: Bearer <token>" \
  -F image="string" \
  -F attributes="default"

Successful Response

{
  "faces": [
    {
      "bounding_box": {
        "left": 0,
        "top": 0,
        "width": 0,
        "height": 0
      },
      "confidence": 0,
      "landmarks": [
        {
          "type": "string",
          "x": 0,
          "y": 0
        }
      ],
      "attributes": {}
    }
  ],
  "image_size": {
    "property1": 0,
    "property2": 0
  }
}

Previous

Compare With Session POST

Next

Compare Faces POST