Passer au contenu principal
La fonctionnalité Estimation de l’âge émet des avertissements dès qu’un signal de risque se déclenche lors du contrôle combiné d’âge et de détection passive du vivant : l’âge prédit est inférieur à votre minimum, l’âge n’a pas pu être calculé, le sujet a échoué au test de détection du vivant, aucun visage n’a été trouvé, ou une attaque par présentation a été détectée. Cette page répertorie chaque code, ce qui le déclenche, et comment configurer la réponse du workflow.

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.
Gravités : les cinq risques de refus automatique (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 est Declined 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éfaut 18 ; 0 désactive la vérification de l’âge). Déclenche AGE_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éfaut 30) ; un score null équivaut à 0. Déclenche LOW_LIVENESS_SCORE. Supprimé lorsque NO_FACE_DETECTED se 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.
Dans les workflows, les vérifications d’âge comparent l’âge estimé tronqué (années entières) aux seuils configurés :
  • 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éfaut 18) déclenche AGE_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, et AGE_NOT_DETECTED n’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éfaut 18) déclenche AGE_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

Dans les payloads de décision de workflow (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

Dernière modification le 7 novembre 2026