kriyam.aistudioAPI reference
API reference

1:1 Face Match

Compare two faces and get a similarity score.

Overview

Post two images and get back whether they show the same person, with a similarity score, the bounding box of each detected face, what face detection read from each face (age range, glasses, eyes open, head angle, brightness and sharpness, …) and a warning for any photo whose quality makes the score less certain. Add advanced_analysis=true for a plain-language AI summary of the result.

  • result.results carries one entry per compared image, in the order the targets were sent. A target the service couldn't use — no face found, too blurry — comes back with an error and a null is_match, which is not the same as a verdict of "not a match"; every other target still returns its own result.
  • quality_warnings and advanced_analysis are advice for a reviewer. Neither ever changes similarity or is_match — those are the comparison's alone.

Endpoints