> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Didit आयु अनुमान के जोखिम कोड: AGE_BELOW_MINIMUM, AGE_NOT_DETECTED, LOW_LIVENESS_SCORE, NO_FACE_DETECTED, थ्रेशोल्ड और कार्रवाइयों सहित संदर्भ।

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

## अवलोकन

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

निर्माता:

* **स्वतंत्र 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](https://docs.didit.me/hi/management-api/lists/overview.md) के माध्यम से प्रबंधित आपकी फ़ेस ब्लॉकलिस्ट में मौजूद किसी प्रविष्टि से मेल खाता है। केवल वर्कफ़्लो सत्रों के लिए। |
| `POSSIBLE_DUPLICATED_FACE` | कॉन्फ़िगर की गई कार्रवाई के अनुसार (डिफ़ॉल्ट `information`, कोई कार्रवाई नहीं) | पहचाना गया चेहरा किसी अन्य सत्र में पहले से स्वीकृत चेहरे से काफ़ी हद तक मिलता-जुलता है (समान `vendor_data` साझा करने वाले मिलान शामिल नहीं हैं)। केवल वर्कफ़्लो सत्रों के लिए। |

## उदाहरण

```json theme={null}
{
  "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` भी होता है जो उस वर्कफ़्लो नोड की पहचान करता है जिसने इसे उत्पन्न किया था।

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

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

## संबंधित

* [आयु अनुमान अवलोकन](https://docs.didit.me/hi/core-technology/age-estimation/overview.md) — सुविधा का व्यवहार, मूल्य निर्धारण, और निर्णय लॉजिक।
* [आयु अनुमान रिपोर्ट](https://docs.didit.me/hi/core-technology/age-estimation/report-age-estimation.md) — स्टैंडअलोन API और एम्बेडेड वर्कफ़्लो वैल्यू दोनों के लिए पूर्ण रिस्पॉन्स संरचना।
* [स्टैंडअलोन API संदर्भ](https://docs.didit.me/hi/standalone-apis/age-estimation.md) — `POST /v3/age-estimation/` अनुरोध और रिस्पॉन्स।
* [पैसिव लाइवनेस](https://docs.didit.me/hi/core-technology/liveness/overview.md) — आयु अनुमान रिस्पॉन्स में उपयोग किया जाने वाला साझा लाइवनेस मॉडल।
* [डेटा मॉडल — आयु अनुमान](https://docs.didit.me/hi/reference/data-models.md#आयु-अनुमान) — फ़ील्ड-दर-फ़ील्ड कैनोनिकल स्कीमा।


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.