Face Detection

Finds the faces in a photograph and returns each one's bounding box, a confidence score and the face itself as a Base64 crop.

POST/v3/store/ekyc/face-detection/single

+1 endpoints

Try it

• Price0.2 ICper request
• Served553.9Kcalls

• v1.0
• Active

Input

OutputPOST /v3/store/ekyc/face-detection/single

bbox

xmax: 320.15 xmin: 100.23 ymax: 450.78 ymin: 150.45

detection_score

0.9998989105224609

face

/9j/4AAQ...base64_encoded_image

message

success

process_time

0.41

Every field, under ResponseOther endpoints: /multi see Request

Request

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-detection/single \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@photo.jpg"

Response

200OK. The fields are explained under Response.

{
    "bbox": {
        "xmax": 320.15,
        "xmin": 100.23,
        "ymax": 450.78,
        "ymin": 150.45
    },
    "detection_score": 0.9998989105224609,
    "face": "/9j/4AAQ...base64_encoded_image",
    "message": "success",
    "process_time": 0.41
}

Request

multipart/form-data, one image per request.

Headers

apikeystringrequired

Your API key, created under API Keys in the control panel.

Body

filefilerequired

The photograph. JPEG or PNG, up to 10 MB.

Endpoint	Returns	Price
/v3/store/ekyc/face-detection/single	The most prominent face	0.2 IC per request
/v3/store/ekyc/face-detection/multi	Every face, up to 50, as result[]	0.3 IC per request

The legacy paths /face_detect_single and /face_detect_multi answer at the same prices.

Response

/single returns one face at the top level, as in the panel; /multi returns the same fields for each face inside result.

bboxobject

The face's box, in pixels of the input image

bbox.xminnumber

bbox.yminnumber

bbox.xmaxnumber

bbox.ymaxnumber

detection_scorenumber

Confidence, 0 to 1

facestring

The face crop, Base64 JPEG

messageprocess_time

success; seconds

Details

Measured

Measure	Result
Time, one face	0.3 to 0.5 s
Time, several faces	0.5 to 1.0 s

Limits

• Up to 50 faces per image.
• Low resolution, poor lighting or focus, head pose and occlusion lower detection_score; check it before relying on a face.

Data handling

Images are processed in memory and not kept after the response. The service is GDPR and PDPA compliant.

Changelog

Version	Date	Changes
1.0	Jan 2023	First release.