Detect faces

This method is available on following paths:
  • POST /v1/detect/

This method detects faces on the provided image. You can either upload the image file as multipart/form-data or provide an URL, which the API will use to fetch the image.

Parameters

Parameter Description Type Accepted in
photo

Url of the photo or the photo itself as multipart upload

Example:
http://static.findface.pro/sample.jpg
url file json body multipart query
emotions

Set to true to extract emotion info from photo

Example:
true
bool json body multipart query
gender

Set to true to extract gender info from photo

bool json body multipart query
age

Set to true to xtract age info from photo

bool json body multipart query

Responses

Status code Description
200

List of faces found on photo and EXIF orientation of the original photo

Example:
{
  "faces": [
    {
      "age": 36,
      "emotions": [
        "neutral",
        "happy"
      ],
      "gender": "female",
      "x1": 236,
      "x2": 311,
      "y1": 345,
      "y2": 419
    }
  ],
  "orientation": 1
}