आयु अनुमान चेतावनियाँ और जोखिम कोड

आयु अनुमान सुविधा तब चेतावनियाँ जारी करती है जब संयुक्त आयु + पैसिव लाइवनेस जांच पर कोई जोखिम संकेत ट्रिगर होता है: अनुमानित आयु आपकी न्यूनतम सीमा से कम है, आयु की गणना नहीं की जा सकी, विषय लाइवनेस में विफल रहा, कोई चेहरा नहीं मिला, या प्रेज़ेंटेशन अटैक का पता चला। यह पेज प्रत्येक कोड, इसे क्या ट्रिगर करता है, और वर्कफ़्लो प्रतिक्रिया को कैसे कॉन्फ़िगर करें, यह सूचीबद्ध करता है।

अवलोकन

आयु अनुमान हमेशा एक कॉल में दो जांच चलाता है — एक पैसिव लाइवनेस परीक्षण और एक आयु रिग्रेशन मॉडल — इसलिए इसकी चेतावनियाँ साझा लाइवनेस पाइपलाइन के माध्यम से प्रवाहित होती हैं और इन्हें LIVENESS सुविधा के साथ टैग किया जाता है। वे रिपोर्ट पर age_estimation.warnings[] (स्वतंत्र API) या liveness_checks[].warnings[] (वर्कफ़्लो में एम्बेडेड) के तहत दिखाई देती हैं। चेतावनी ऑब्जेक्ट स्कीमा को डेटा मॉडल — चेतावनी ऑब्जेक्ट के अंतर्गत प्रलेखित किया गया है। निर्माता:

स्वतंत्र API — यह endpoint अस्वीकृति ट्रिगर के अंतर्गत सूचीबद्ध पाँच चेतावनियाँ उत्पन्न करता है।
वर्कफ़्लो — साझा लाइवनेस निर्माता और साथ ही आयु-विशिष्ट जांच। आयु चेतावनियाँ केवल आयु-अनुमान फ़्लो (अनुकूली आयु सत्यापन वर्कफ़्लो या AGE_ESTIMATION वर्कफ़्लो नोड्स) पर ही ट्रिगर होती हैं — एक सामान्य लाइवनेस चरण एक अनुमानित आयु की रिपोर्ट करता है लेकिन कभी भी आयु चेतावनियाँ नहीं उठाता है।

गंभीरताएं: पाँच स्वचालित-अस्वीकार जोखिम (NO_FACE_DETECTED, LIVENESS_FACE_ATTACK, FACE_IN_BLOCKLIST, AGE_BELOW_MINIMUM, AGE_NOT_DETECTED) हमेशा log_type: "error" होते हैं और Declined को बाध्य करते हैं; शेष जोखिम थ्रेशोल्ड या कॉन्फ़िगर की गई कार्रवाई के आधार पर error / warning / information में रिज़ॉल्व होते हैं।

अस्वीकृति ट्रिगर

स्वतंत्र API पर, निर्णय Declined होता है जब भी कोई भी चेतावनी ट्रिगर होती है:

थ्रेशोल्ड से कम आयु — अनुमानित आयु age_estimation_decline_threshold से पूर्णतः कम है (डिफ़ॉल्ट 18; 0 आयु जांच को अक्षम करता है)। AGE_BELOW_MINIMUM उठाता है।
आयु की गणना नहीं की गई — किसी चेहरे की आयु का अनुमान नहीं लगाया जा सका (कोई पता लगाने योग्य चेहरा नहीं, या आयु मॉडल के लिए कोई प्रयोग करने योग्य चेहरा नहीं)। AGE_NOT_DETECTED उठाता है।
लाइवनेस स्कोर थ्रेशोल्ड पर या उससे कम — score <= face_liveness_score_decline_threshold (डिफ़ॉल्ट 30); एक null स्कोर 0 माना जाता है। LOW_LIVENESS_SCORE उठाता है। NO_FACE_DETECTED ट्रिगर होने पर दबा दिया जाता है — दोनों परस्पर अनन्य हैं।
कोई चेहरा नहीं मिला — लाइवनेस मॉडल को कोई चेहरा नहीं मिला। NO_FACE_DETECTED उठाता है।
प्रेज़ेंटेशन अटैक — लाइवनेस मॉडल ने स्क्रीन, मुद्रित फ़ोटो, मास्क या अन्य स्पूफ़ को चिह्नित किया। LIVENESS_FACE_ATTACK उठाता है।

वर्कफ़्लो में, आयु जांच कॉन्फ़िगर किए गए थ्रेशोल्ड के विरुद्ध काटी गई अनुमानित आयु (पूर्ण वर्षों में) की तुलना करती है:

सक्षम पहचान सत्यापन फ़ॉलबैक के साथ (enable_id_verification_fallback, डिफ़ॉल्ट रूप से चालू): borderline_minimum_age_threshold (डिफ़ॉल्ट 18) से कम आयु AGE_BELOW_MINIMUM उठाती है; सीमांत बैंड (अधिकतम सीमा borderline_maximum_age_threshold तक) में आने वाली आयु वाले मामलों को चेतावनी उठाने के बजाय दस्तावेज़ सत्यापन के लिए आगे भेजा जाता है, और AGE_NOT_DETECTED कभी नहीं उठाया जाता है — न पहचाने जा सकने वाली आयु भी दस्तावेज़ सत्यापन के लिए रूट हो जाती है।
फ़ॉलबैक अक्षम होने पर: कोई अनुमानित आयु न होने पर AGE_NOT_DETECTED उठाया जाता है, और minimum_age_threshold (डिफ़ॉल्ट 18) से कम आयु AGE_BELOW_MINIMUM उठाती है।

कॉन्फ़िगर किए जा सकने वाले जोखिम

निम्नलिखित जोखिम आपको प्रति वर्कफ़्लो सेटिंग के अनुसार थ्रेशोल्ड या कार्रवाई को ट्यून करने की अनुमति देते हैं:

सेटिंग	जोखिम कोड	कॉन्फ़िगर किए जा सकने वाले विकल्प
आयु थ्रेशोल्ड	`AGE_BELOW_MINIMUM`	स्वतंत्र: `age_estimation_decline_threshold` (डिफ़ॉल्ट `18`, `0` अक्षम करता है)। वर्कफ़्लो: `minimum_age_threshold` / `borderline_minimum_age_threshold` (डिफ़ॉल्ट `18`) और साथ ही सीमांत आयु के लिए पहचान सत्यापन फ़ॉलबैक।
कम लाइवनेस स्कोर	`LOW_LIVENESS_SCORE`	लाइवनेस स्कोर पर लागू अलग-अलग अस्वीकार सीमा (डिफ़ॉल्ट `30` → `error` + अस्वीकार) और समीक्षा सीमा (डिफ़ॉल्ट `60` → `warning` + समीक्षा)।
संभावित डुप्लिकेट चेहरा	`POSSIBLE_DUPLICATED_FACE`	पहचान पर कार्रवाई: `DECLINE` / `REVIEW` / `NO_ACTION` (डिफ़ॉल्ट `NO_ACTION`)। केवल वर्कफ़्लो सत्र।
एकाधिक चेहरे	`MULTIPLE_FACES_DETECTED`	पहचान पर कार्रवाई: `DECLINE` / `REVIEW` / `NO_ACTION` (डिफ़ॉल्ट `NO_ACTION`)। केवल वर्कफ़्लो पैसिव लाइवनेस।

वर्कफ़्लो सत्र आपकी सूचियों के विरुद्ध चेहरे की जांच भी करते हैं: FACE_IN_BLOCKLIST हमेशा स्वचालित रूप से अस्वीकार (error) करता है, जबकि POSSIBLE_FACE_IN_BLOCKLIST सत्र को In Review में ले जाता है।

उत्पन्न होने वाली चेतावनियाँ

टैग	गंभीरता (`log_type`)	विवरण
`AGE_BELOW_MINIMUM`	`error` — ऑटो-अस्वीकृत	अनुमानित आयु सक्रिय थ्रेशोल्ड से कम है (स्टैंडअलोन `age_estimation_decline_threshold`; वर्कफ़्लो `minimum_age_threshold` / `borderline_minimum_age_threshold`; सभी के लिए डिफ़ॉल्ट `18` है)। `additional_data` हमेशा `null` होता है।
`AGE_NOT_DETECTED`	`error` — ऑटो-अस्वीकृत	चेहरे की आयु का अनुमान नहीं लगाया जा सका। आयु `null` होने पर स्टैंडअलोन API द्वारा हमेशा उत्पन्न किया जाता है; वर्कफ़्लो में केवल तभी जब पहचान सत्यापन फ़ॉलबैक अक्षम हो।
`LOW_LIVENESS_SCORE`	अस्वीकृति थ्रेशोल्ड पर/नीचे होने पर `error`; समीक्षा थ्रेशोल्ड पर/नीचे होने पर `warning`	लाइवनेस स्कोर कॉन्फ़िगर किए गए थ्रेशोल्ड पर या उससे नीचे है (स्टैंडअलोन और वर्कफ़्लो अस्वीकृति डिफ़ॉल्ट `30`; वर्कफ़्लो समीक्षा डिफ़ॉल्ट `60`), जो किसी स्थिर फ़ोटो, स्क्रीन या वीडियो के संभावित उपयोग का संकेत देता है। `NO_FACE_DETECTED` ट्रिगर होने पर यह उत्पन्न नहीं किया जाता है।
`NO_FACE_DETECTED`	`error` — ऑटो-अस्वीकृत	सबमिट की गई इमेज में कोई चेहरा नहीं पाया गया। उपयोगकर्ता को पर्याप्त रोशनी के साथ कैमरे को केंद्र में रखने के लिए पुनः संकेत दें।
`LIVENESS_FACE_ATTACK`	`error` — ऑटो-अस्वीकृत	लाइवनेस मॉडल ने प्रेज़ेंटेशन अटैक (स्क्रीन रीप्ले, प्रिंटेड फ़ोटो, मास्क, डीपफ़ेक) को फ़्लैग किया।
`MULTIPLE_FACES_DETECTED`	कॉन्फ़िगर की गई कार्रवाई के अनुसार (डिफ़ॉल्ट `information`, कोई कार्रवाई नहीं)	इमेज में एक से अधिक चेहरे पाए गए; सबसे बड़ा चेहरा परिणाम निर्धारित करता है। केवल वर्कफ़्लो पैसिव लाइवनेस में — स्टैंडअलोन API इसे उत्पन्न नहीं करता है।
`FACE_IN_BLOCKLIST`	`error` — ऑटो-अस्वीकृत	पहचाना गया चेहरा Lists API के माध्यम से प्रबंधित आपकी फ़ेस ब्लॉकलिस्ट में मौजूद किसी प्रविष्टि से मेल खाता है। केवल वर्कफ़्लो सत्रों के लिए।
`POSSIBLE_DUPLICATED_FACE`	कॉन्फ़िगर की गई कार्रवाई के अनुसार (डिफ़ॉल्ट `information`, कोई कार्रवाई नहीं)	पहचाना गया चेहरा किसी अन्य सत्र में पहले से स्वीकृत चेहरे से काफ़ी हद तक मिलता-जुलता है (समान `vendor_data` साझा करने वाले मिलान शामिल नहीं हैं)। केवल वर्कफ़्लो सत्रों के लिए।

उदाहरण

{
  "warnings": [
    {
      "risk": "LOW_LIVENESS_SCORE",
      "feature": "LIVENESS",
      "additional_data": null,
      "log_type": "error",
      "short_description": "Low liveness score",
      "long_description": "The liveness check resulted in a low score, indicating potential use of non-live facial representations or poor-quality biometric data."
    },
    {
      "risk": "AGE_BELOW_MINIMUM",
      "feature": "LIVENESS",
      "additional_data": null,
      "log_type": "error",
      "short_description": "Age below minimum",
      "long_description": "The age of the face is below the minimum age threshold for the application."
    }
  ]
}

वर्कफ़्लो निर्णय payload (liveness_checks[].warnings[]) में, प्रत्येक चेतावनी में एक node_id भी होता है जो उस वर्कफ़्लो नोड की पहचान करता है जिसने इसे उत्पन्न किया था।

चेतावनी के प्रकार

आपके एप्लिकेशन के कॉन्फ़िगरेशन के आधार पर प्रत्येक जोखिम को एक गंभीरता सौंपी जाती है। गंभीरताएँ तीन श्रेणियों में आती हैं:

प्रमाणीकरण

सत्यापन

निगरानी

प्लेटफ़ॉर्म

आयु अनुमान चेतावनियाँ और जोखिम कोड

अवलोकन

अस्वीकृति ट्रिगर

कॉन्फ़िगर किए जा सकने वाले जोखिम

उत्पन्न होने वाली चेतावनियाँ

उदाहरण

चेतावनी के प्रकार

संबंधित

​अवलोकन

​अस्वीकृति ट्रिगर

​कॉन्फ़िगर किए जा सकने वाले जोखिम

​उत्पन्न होने वाली चेतावनियाँ

​उदाहरण

​चेतावनी के प्रकार

​संबंधित

अवलोकन

अस्वीकृति ट्रिगर

कॉन्फ़िगर किए जा सकने वाले जोखिम

उत्पन्न होने वाली चेतावनियाँ

उदाहरण

चेतावनी के प्रकार

संबंधित