ID Verification：FACE_IDU_MIN

名稱

類型

是否必選

描述

樣本值

ProductCode

String

是

產品Code：FACE_IDU_MIN。

FACE_IDU_MIN

MerchantBizId

String

是

自訂的業務唯一標識，用於後續定位和排查問題。支援長度為 32 位的字母和數位組合，請確保唯一。

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

是

自訂的使用者識別碼，或者其他可以識別特定使用者的標識，例如：手機號碼、郵箱地址等。強烈建議對該欄位的值進行預先脫敏，例如對值進行雜湊處理。

123456789

VerifyModel

String

是

驗證類型：

• 0：檢索模式

  • 功能：傳入人臉庫和使用者人臉圖片（SourceFacePicture/SourceFacePictureUrl/FacePictureFile），系統自動檢索人臉庫中是否已經存在該人臉圖片，使用者人臉圖片支援開啟靜默活體檢測。

  • 建議情境：真人註冊帳號且不允許重複註冊情境。

• 1：驗證模式（預設）

  • 功能：傳入指定人臉圖片（SourceFacePicture/SourceFacePictureUrl/FacePictureFile）與留底人臉圖片（TargetFacePicture/TargetFacePictureUrl/TargetFacePictureFile），系統自動驗證兩者的人臉資訊是否一致，且指定人臉圖片支援開啟靜默活體檢測。

  • 建議情境：修改登入、帳號等資訊時需驗證是否為本人操作的情境。

• 2：綜合模式

  • 功能：同時傳入人臉庫、指定人臉圖片（SourceFacePicture/SourceFacePictureUrl/FacePictureFile）與留底人臉圖片（TargetFacePicture/TargetFacePictureUrl/TargetFacePictureFile），系統自動檢索人臉庫中是否存在指定人臉圖片，是否與留底人臉一致，且指定人臉圖片支援開啟靜默活體檢測。

  • 建議情境：需要驗證是新增使用者且是本人操作環境。

0

FaceGroupCodes

String

否

通過ID Verification產品控制台建立人臉庫時擷取對應編碼，最大支援同時查詢10個人臉庫。當傳入多個人臉庫編碼時，以逗號區分。

1232344,23444

SourceFacePicture

String

否

人像圖片 Base 64 編碼。

base64

SourceFacePictureUrl

String

否

人像圖片地址，公網可訪問的 HTTP、HTTPS 連結。

https://***face1.jpeg

SourceFacePictureFile

String

否

人像圖片檔案流

人像圖片檔案流1

TargetFacePicture

String

否

底圖人像圖片 Base 64 編碼。

base64

TargetFacePictureUrl

String

否

底圖人像圖片地址，公網可訪問的 HTTP、HTTPS 連結。

https://***face2.jpeg

TargetFacePictureFile

String

否

對比底圖，底圖人像圖片檔案流。

人像圖片檔案流2

AutoRegistration

String

否

檢索不存在的人臉時，是否自動註冊人臉到指定人臉庫下。

• 0：自動註冊

• 1：不註冊（預設）

0

FaceRegisterGroupCode

String

否

註冊人臉庫。

0e0c34a77f

ReturnFaces

String

否

指匹配閾值之上存在多個人臉時，可通過該參數自訂返回數量。

• 預設返回 1

• 最大支援 5

1

FaceQualityCheck

String

否

N

FaceAttributeCheck

String

否

N

名稱

類型

描述

樣本值

HTTP Status Code

Integer

HTTP狀態代碼。

200

HTTP Body

RequestId

String

請求ID。

130A2C10-B9EE-4D84-88E3-5384FF0****

Code

String

返回Code，具體資訊請參見服務端返回HTTP狀態代碼說明。

Success

Message

String

返回Code的詳細描述。

success

Result.FacePassed

String

認證最終結果，取值：

• Y：通過

• N：不通過

Y

Result.FaceComparisonScore

Double

當驗證模式為 1 或 2 時返回 1:1 驗證的比對分。其取值範圍為：0～100。

98

Result.DuplicateFace

String

當檢索存在重複人臉時返回人臉庫中對應的人臉ID、使用者ID和比對分。

[
  {
    "faceGroupCode": "sg7****uzt",
    "faceId": "f5a921*******9e792ec84c8f0ca592a"
    "merchantUserId":"face0005",
    "score":93.26
  }
]

Result.FaceRegistrationResult

Integer

人臉註冊結果

• 0：失敗

• 1：成功

1

Result.FaceRegistrationId

String

當設定自動註冊，且人臉註冊成功時返回對應的FACEID。

9e792******a592a

Result.FaceAttack

String

採集人臉是否涉及活體攻擊，攻擊為 Y，否則為 N。 當開啟靜默活體檢測時返回。

N

Result.FaceAttributeInfo

String

{
        gender: 1
        glasses: 0
        hat: 1
        mask: 1
        tattoo: 0
        smoking: 0
        others: 1
        env：office
        expression：1
        age：16
}

Result.SubCode

String

認證結果描述。請參考SubCode。

200

Result.TransactionId

String

認證請求的唯一標識。

4ab0b***cbde97

Result.ExtFaceInfo

Object

活體檢測相關結果資訊。關於JSON格式，請參見右側樣本。更多資訊，請參見ExtFaceInfo說明。

{
  "FaceQualityScore": 66.3,
  "OcclusionScore": 100,
  "SharpnessScore": 70.3,
  "KaOcclusionScore": 80,
  "IlluminationScore": 90.79
}

名稱

類型

描述

樣本值

FaceQualityScore

Double

活體人臉品質分數。取值範圍0～100，數值越大品質越高。

88.62

OcclusionScore

Double

品質判斷子維度，遮擋的演算法分數，取值範圍0～100，數值越大品質越高。

99.99

KaOcclusionScore

Double

品質判斷子維度，關鍵地區遮擋的演算法分數，取值範圍0～100，數值越大品質越高。

100

IlluminationScore

Double

品質判斷子維度，光照的演算法分數，取值範圍0～100，數值越大品質越高。

97.43

SharpnessScore

Double

品質判斷子維度，圖片清晰度分數，取值範圍0～100，數值越大品質越高。

60.78