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 funcionalitatLIVENESS. 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.
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ó ésDeclined sempre que s’activi qualsevol advertència:
- Edat per sota del llindar — edat estimada estrictament per sota de
age_estimation_decline_threshold(per defecte18;0desactiva la comprovació d’edat). EmetAGE_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 defecte30); una puntuaciónullcompta com a0. EmetLOW_LIVENESS_SCORE. Se suprimeix quan s’activaNO_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.
- Amb alternativa de verificació d’identitat activada (
enable_id_verification_fallback, activada per defecte): una edat per sota deborderline_minimum_age_threshold(per defecte18) emetAGE_BELOW_MINIMUM; les edats a la franja límit (fins aborderline_maximum_age_threshold) passen a la verificació del document en lloc d’emetre una advertència, i mai s’emetAGE_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 deminimum_age_threshold(per defecte18) emetAGE_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
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
- Visió general de l’estimació d’edat — comportament de la funcionalitat, preus i lògica de decisió.
- Informe de l’estimació d’edat — format complet de la resposta tant per a l’API independent com per al valor integrat al flux de treball.
- Referència de l’API independent — sol·licitud i resposta de
POST /v3/age-estimation/. - Prova de vida passiva — el model compartit de prova de vida utilitzat a les respostes d’estimació d’edat.
- Models de dades — estimació d’edat — esquema canònic camp per camp.