Face Analytics

Detect faces and return age, gender, and liveness analysis for each face. No face recognition or database operations are performed.

POST/api/v1/face_analytics

Analyze faces in an image for age estimation, gender classification, and passive liveness detection. Returns results for every face detected.

Headers

Name	Required	Description
x-key-secret	Yes	Your API key

Body (multipart/form-data)

Name	Type	Required
face_image	file	Yes

cURL

curl -X POST "https://faceapi.arsa.technology/api/v1/face_analytics" \
  -H "x-key-secret: YOUR_API_KEY" \
  -F "face_image=@photo.jpg"

Response

200 OK

{
  "status": "success",
  "face_count": 1,
  "faces": [
    {
      "bbox": {
        "x1": 0.12, "y1": 0.08,
        "x2": 0.45, "y2": 0.52
      },
      "passive_liveness": {
        "is_real_face": true,
        "liveness_probability": 0.97
      },
      "age": 28.7,
      "gender": "female",
      "gender_probability": 0.88
    }
  ],
  "latency_ms": 189.23
}

Response Fields

Field	Type	Description
face_count	integer	Number of faces detected
bbox	object	Normalized bounding box (0-1 range)
age	float	Estimated age (0-100)
gender	string	"female" or "male"
gender_probability	float	Confidence score (0-1)
is_real_face	boolean	Passive liveness: true if real face
liveness_probability	float	Liveness confidence (0-1)

Age & Gender in Recognition

The /face_recognition/recognize_face and /face_recognition/validate_faces endpoints also include age, gender, and gender_probability fields in their response.