Saltar al contingut principal
La funcionalitat d’Estimació d’edat emet advertències sempre que s’activa un senyal de risc en la comprovació combinada d’edat i prova de vida passiva: l’edat estimada està per sota del teu mínim, no s’ha pogut calcular l’edat, el subjecte no ha superat la prova de vida, no s’ha trobat cap cara o s’ha detectat un atac de presentació. Aquesta pàgina enumera tots els codis, què els activa i com configurar la resposta del flux de treball.

Visió general

L’Estimació d’edat sempre executa dues comprovacions en una sola crida —una prova de vida passiva i un model de regressió d’edat—, de manera que les seves advertències passen pel canal compartit de prova de vida i s’etiqueten amb la funcionalitat LIVENESS. Apareixen a l’informe a age_estimation.warnings[] (API independent) o a liveness_checks[].warnings[] (integrat en un flux de treball). L’esquema de l’objecte d’advertència està documentat a Models de dades — Objecte d’advertència. Generadors:
  • API independent — l’endpoint genera les cinc advertències enumerades a Activadors de denegació.
  • Fluxos de treball — els generadors compartits de prova de vida més les comprovacions específiques d’edat. Les advertències d’edat només s’activen en fluxos d’estimació d’edat (fluxos de treball adaptatius de verificació d’edat o nodes de flux de treball AGE_ESTIMATION); un pas simple de prova de vida informa d’una edat estimada però mai emet advertències d’edat.
Gravetats: els cinc riscos de denegació automàtica (NO_FACE_DETECTED, LIVENESS_FACE_ATTACK, FACE_IN_BLOCKLIST, AGE_BELOW_MINIMUM, AGE_NOT_DETECTED) són sempre log_type: "error" i forcen l’estat Declined; la resta de riscos donen lloc a error / warning / information segons els llindars o l’acció configurada.

Activadors de denegació

A l’API independent, la decisió és Declined sempre que s’activi qualsevol advertència:
  • Edat per sota del llindar — edat estimada estrictament per sota de age_estimation_decline_threshold (per defecte 18; 0 desactiva la comprovació d’edat). Emet AGE_BELOW_MINIMUM.
  • Edat no calculada — no s’ha pogut estimar l’edat de la cara (no hi ha cap cara detectable o no hi ha cap cara utilitzable per al model d’edat). Emet AGE_NOT_DETECTED.
  • Puntuació de prova de vida igual o inferior al llindar — score <= face_liveness_score_decline_threshold (per defecte 30); una puntuació null compta com a 0. Emet LOW_LIVENESS_SCORE. Se suprimeix quan s’activa NO_FACE_DETECTED (tots dos s’exclouen mútuament).
  • No s’ha detectat cap cara — el model de prova de vida no ha trobat cap cara. Emet NO_FACE_DETECTED.
  • Atac de presentació — el model de prova de vida ha detectat una pantalla, una foto impresa, una màscara o una altra suplantació. Emet LIVENESS_FACE_ATTACK.
Als fluxos de treball, les comprovacions d’edat comparen l’edat estimada truncada (anys enters) amb els llindars configurats:
  • Amb alternativa de verificació d’identitat activada (enable_id_verification_fallback, activada per defecte): una edat per sota de borderline_minimum_age_threshold (per defecte 18) emet AGE_BELOW_MINIMUM; les edats a la franja límit (fins a borderline_maximum_age_threshold) passen a la verificació del document en lloc d’emetre una advertència, i mai s’emet AGE_NOT_DETECTED (una edat no detectada també es redirigeix cap a la verificació del document).
  • Amb l’alternativa desactivada: si no hi ha cap edat estimada, s’emet AGE_NOT_DETECTED, i una edat per sota de minimum_age_threshold (per defecte 18) emet AGE_BELOW_MINIMUM.

Riscos configurables

Els riscos següents et permeten ajustar els llindars o l’acció segons la configuració del flux de treball: Les sessions de fluxos de treball també comproven la cara amb les teves llistes: FACE_IN_BLOCKLIST sempre denega automàticament (error), mentre que POSSIBLE_FACE_IN_BLOCKLIST passa la sessió a In Review.

Advertències generades

Exemple

Als payloads de decisió del flux de treball (liveness_checks[].warnings[]), cada advertència també inclou un node_id que identifica el node del flux de treball que la va generar.

Tipus d’advertència

A cada risc se li assigna una severitat en funció de la configuració de la teva aplicació. Les severitats es divideixen en tres categories:

Contingut relacionat

Darrera modificació el 7 de novembre del 2026