年龄估算警告与风险代码

​

概述

• 独立 API：该 endpoint 会生成拒绝触发条件下列出的五种警告。
• 工作流：共享的活体检测生成来源加上特定于年龄的检测。年龄警告仅在年龄估算流程（自适应年龄验证工作流或 AGE_ESTIMATION 工作流节点）中触发；普通的活体检测步骤会报告预估年龄，但绝不会触发年龄警告。

​

拒绝触发条件

• 年龄低于阈值：预测年龄严格低于 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。

​

可配置风险

​

生成的警告

​

示例

{
  "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."
    }
  ]
}

​

警告类型

​

相关内容

• 年龄估算概述 — 功能表现、定价以及决策逻辑。
• 年龄估算报告 — 独立 API 和嵌入式工作流取值的完整响应结构。
• 独立 API 参考 — POST /v3/age-estimation/ 请求和响应。
• 被动活体检测 — 年龄估算响应中使用的共享活体检测模型。
• 数据模型 — 年龄估算 — 规范的逐字段架构。