Vue d’ensemble
L’Estimation de l’âge exécute toujours deux vérifications en un seul appel — un test de détection passive du vivant et un modèle de régression de l’âge — de sorte que ses avertissements transitent par le pipeline partagé de détection du vivant et sont étiquetés avec la fonctionnalitéLIVENESS. Ils apparaissent sur le rapport sous age_estimation.warnings[] (API autonome) ou liveness_checks[].warnings[] (intégré dans un workflow). Le schéma de l’objet d’avertissement est documenté sous Modèles de données — Objet d’avertissement.
Émetteurs :
- API autonome — l’endpoint génère les cinq avertissements répertoriés sous Déclencheurs de refus.
- Workflows — les émetteurs partagés de détection du vivant ainsi que les vérifications spécifiques à l’âge. Les avertissements d’âge ne se déclenchent que sur les flux d’estimation de l’âge (workflows de vérification adaptative de l’âge ou nœuds de workflow
AGE_ESTIMATION) — une simple étape de détection du vivant signale un âge estimé mais n’émet jamais d’avertissements d’âge.
NO_FACE_DETECTED, LIVENESS_FACE_ATTACK, FACE_IN_BLOCKLIST, AGE_BELOW_MINIMUM, AGE_NOT_DETECTED) sont toujours log_type: "error" et imposent la décision Declined ; les autres risques sont associés à error / warning / information en fonction des seuils ou de l’action configurée.
Déclencheurs de refus
Sur l’API autonome, la décision estDeclined dès que n’importe quel avertissement se déclenche :
- Âge inférieur au seuil — âge prédit strictement inférieur à
age_estimation_decline_threshold(par défaut18;0désactive la vérification de l’âge). DéclencheAGE_BELOW_MINIMUM. - Âge non calculé — aucun âge n’a pu être estimé à partir du visage (aucun visage détectable, ou aucun visage exploitable pour le modèle d’âge). Déclenche
AGE_NOT_DETECTED. - Score de détection du vivant inférieur ou égal au seuil —
score <= face_liveness_score_decline_threshold(par défaut30) ; un scorenulléquivaut à0. DéclencheLOW_LIVENESS_SCORE. Supprimé lorsqueNO_FACE_DETECTEDse déclenche — les deux sont mutuellement exclusifs. - Aucun visage détecté — le modèle de détection du vivant n’a trouvé aucun visage. Déclenche
NO_FACE_DETECTED. - Attaque par présentation — le modèle de détection du vivant a signalé un écran, une photo imprimée, un masque ou une autre usurpation. Déclenche
LIVENESS_FACE_ATTACK.
- Avec le repli de vérification d’identité activé (
enable_id_verification_fallback, activé par défaut) : un âge inférieur àborderline_minimum_age_threshold(par défaut18) déclencheAGE_BELOW_MINIMUM; les utilisateurs dont l’âge se situe dans la tranche limite (jusqu’àborderline_maximum_age_threshold) sont orientés vers la vérification des documents au lieu de déclencher un avertissement, etAGE_NOT_DETECTEDn’est jamais déclenché — un âge non détecté est également redirigé vers la vérification des documents. - Avec le repli désactivé : l’absence d’âge estimé déclenche
AGE_NOT_DETECTED, et un âge inférieur àminimum_age_threshold(par défaut18) déclencheAGE_BELOW_MINIMUM.
Risques configurables
Les risques suivants vous permettent d’ajuster les seuils ou l’action selon les paramètres du workflow :
Les sessions de workflow comparent également le visage à vos listes :
FACE_IN_BLOCKLIST entraîne toujours un refus automatique (error), tandis que POSSIBLE_FACE_IN_BLOCKLIST fait passer la session au statut In Review.
Avertissements générés
Exemple
liveness_checks[].warnings[]), chaque avertissement comporte également un node_id identifiant le nœud de workflow qui l’a déclenché.
Types d’avertissement
Chaque risque se voit attribuer une gravité en fonction de la configuration de votre application. Les gravités se répartissent en trois catégories :Pages connexes
- Vue d’ensemble de l’estimation de l’âge — comportement de la fonctionnalité, tarifs et logique de décision.
- Rapport d’estimation de l’âge — structure complète de la réponse pour l’API autonome et la valeur intégrée au workflow.
- Référence de l’API autonome — requête et réponse
POST /v3/age-estimation/. - Détection passive du vivant — le modèle partagé de détection du vivant utilisé dans les réponses d’estimation de l’âge.
- Modèles de données — estimation de l’âge — schéma de référence champ par champ.