​
Image Quality Requirements

Resolution

Use high-resolution images (minimum 640x480 pixels) for better detection accuracy.

Format

Supported formats: JPEG, PNG, WebP. Ensure proper compression without quality loss.

Lighting

Ensure adequate, even lighting without harsh shadows or overexposure.

Focus

Images should be clear and in focus, avoiding blurry or pixelated content.

​
Image Content Constraints

​
1. Face Area

  • Only one visible face allowed
  • Face must be fully visible — no cropping at top, sides, or chin- Minimum face box size: 150 x 150 pixels
  • Minimum pupil-to-pupil distance (distance between eyes): 50 pixels or more
  • Padding between face and image borders: at least 15 pixels
  • No occlusions (e.g. hair, hand, mask, accessories)
  • No background faces or partial faces in the image

​
2. Face Orientation

  • Frontal face required
  • Pitch / yaw angle must be within ±30 degrees
  • No extreme tilt or side-view
  • Eyes, nose, and mouth must be symmetrically aligned

​
Conditions That May Cause Failure

  • Motion blur
  • Filtered images (e.g. texture smoothing, beautify filters)
  • Strong light reflections or glare on the face
  • Low light or colored lighting conditions
  • Wide-angle or fish-eye lens distortion
  • Sunglasses or heavily tinted glasses

​
Content Guidelines

1

Natural Expression

Capture natural facial expressions without forced smiles or exaggerated poses.
2

Direct Gaze

Eyes should be open and looking directly at the camera for optimal detection.
3

Full Face

Ensure the entire face is visible, including ears and hairline when possible.
4

No Obstructions

Avoid glasses, masks, hats, or other items that may cover facial features.

​
Common Issues to Avoid

Poor Lighting

Avoid low light conditions, harsh shadows, or overexposed images that may interfere with detection.

Blurry Images

Ensure images are clear and in focus. Blurry images may result in detection failures.

Partial Face

Avoid cropping that cuts off parts of the face or showing only partial facial features.

Multiple Faces

Images should contain only one face. Multiple faces may cause detection issues.

Reflections

Avoid reflections on glasses or other surfaces that may interfere with facial analysis.

​
Technical Requirements

​
Success Tips

1

Test with Sample Images

Use our sample images to test the API before implementing in production.
2

Implement Retry Logic

Add retry mechanisms for failed requests due to temporary issues.
3

Monitor Response Times

Track API response times and adjust image sizes if needed.
4

Validate Results

Always validate the liveness score and implement appropriate thresholds for your use case.

​
Photo Guidelines

Alt text describing the image