年齢推定の警告とリスクコード一覧

​

概要

• スタンドアロンAPI：エンドポイントは却下のトリガーに記載の5つの警告を生成します。
• ワークフロー：共通のライブネスの生成元と、年齢固有のチェックです。年齢に関する警告は年齢推定フロー（適応型年齢認証ワークフローまたは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が発生した場合は抑制されます（この2つは相互に排他的です）。
• 顔が検出されない：ライブネスモデルが顔を見つけられなかった場合です。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/のリクエストとレスポンス。
• パッシブライブネス：年齢推定のレスポンスで使用される共通のライブネスモデル。
• データモデル：年齢推定：フィールドごとの正式なスキーマ。