Age Verification API Documentation
The Age Verification API utilises a vision-based Artificial Intelligent (AI) model to determine if the age of the input face meets specified criteria. This process involves the following steps:
- Estimate Age: The API estimates the age based on the input facial image.
- Calculate Distance: The
distance
is calculated as the difference between the estimated age and a user-defined age threshold. - Determine Confidence: The API uses specific thresholds values to ascertain the confidence level of the age verification result.
Verification Outcomes
For verify_over(image, age_threshold)
The distance = estimated_age - age_threshold
is the difference between the estimated age and the threshold age.
There are four possible outcomes for the verify_over
function:
FALSE
: the estimated age is less than the threshold age as thedistance
< 0.TRUE_MODERATE
: the estimated age is over the threshold age with moderate confidence, as thedistance
is between 0 and theHigh Confidence Distance
.TRUE_HIGH
: the estimated age is over the threshold age with high confidence, as thedistance
is between theHigh Confidence Distance
and theVery High Confidence Distance
.TRUE_VERY_HIGH
: the estimated age is over the threshold age with very high confidence, as thedistance
is greater than theVery High Confidence Distance
.
Note: The High Confidence Distance
and Very High Confidence Distance
are preset values that determine the confidence level of the age verification result based on our benchmarking on large population datasets. They are 0.75 and 1.5 years respectively for verify_over
function.
For verify_under(image, age_threshold)
The distance = estimated_age - age_threshold
is the difference between the estimated age and the threshold age.
There are four possible outcomes for the verify_under
function:
FALSE
: the estimated age is over the threshold age, as thedistance
> 0.TRUE_MODERATE
: the estimated age is under the threshold age with moderate confidence, as thedistance
is between 0 and theHigh Confidence Distance
.TRUE_HIGH
: the estimated age is under the threshold age with high confidence, as thedistance
is between theHigh Confidence Distance
and theVery High Confidence Distance
.TRUE_VERY_HIGH
: the estimated age is under the threshold age with very high confidence, as thedistance
is smaller than theVery High Confidence Distance
.
Note: The High Confidence Distance
and Very High Confidence Distance
are preset values that determine the confidence level of the age verification result based on our benchmarking on large population datasets. They are -1.3 and -2.6 years respectively for verify_under
function.