ID Verification：FACE_IDU_MIN

名稱

類型

是否必選

描述

樣本值

ProductCode

String

是

產品Code：FACE_IDU_MIN。

FACE_IDU_MIN

SceneCode

String

否

自訂的認證情境 ID。

1234567890

MerchantBizId

String

是

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

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

是

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

123456789

VerifyModel

String

是

驗證類型：

• 0：檢索模式

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

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

• 1：驗證模式（預設）

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

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

• 2：綜合模式

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

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

0

Liveness

String

否

是否開啟靜默活體檢測。

• 0：不開啟

• 1：開啟

0

FaceGroupCodes

String

否

通過控制台建立的人臉庫編碼，最大支援同時查詢 10 個人臉庫。當傳入多個人臉庫編碼時，以逗號區分。

1232344,23444

SourceFacePicture

String

否

人像圖片 Base 64 編碼。

base64

SourceFacePictureUrl

String

否

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

https://***face1.jpeg

TargetFacePicture

String

否

人像圖片 Base 64 編碼。

base64

TargetFacePictureUrl

String

否

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

https://***face2.jpeg

AutoRegistration

String

否

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

• 0：自動註冊

• 1：不註冊（預設）

0

FaceRegisterGroupCode

String

否

註冊人臉庫。

0e0c34a77f

SaveFacePicture

String

否

預留欄位，暫未生效。

FaceVerifyThreshold

String

否

預留欄位，暫未生效。

ReturnFaces

String

否

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

• 預設返回 1

• 最大支援 5

1

名稱

類型

描述

樣本值

HTTP Status Code

Integer

HTTP狀態代碼。

200

HTTP Body

RequestId

String

請求ID。

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

Code

String

返回Code。

Success

Message

String

返回Code的詳細描述。

success

Result.FacePassed

String

認證最終結果，取值：

• Y：通過

• N：不通過

Y

Result.FaceComparisonScore

String

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

98

Result.DuplicateFace

String

存在重複人臉時，返回檢索到的人臉庫人臉 ID 和 UserID。

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

Result.FaceRegistrationResult

String

人臉註冊結果

• 0：失敗

• 1：成功

1

Result.FaceRegistrationId

String

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

9e792******a592a

Result.FaceAttack

String

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

N

Result.FaceAttackScore

String

人臉靜默活體檢測攻擊的機率。取值範圍：0～100。當開啟靜默活體檢測時返回。

99

Result.FaceAge

String

人臉預測的參考年齡，可能存在預測失敗無法返回的情況。

30

Result.FaceGender

String

人臉圖片預測的性別，可能存在預測失敗無法返回的情況。

• M：男

• F：女

M

Result.SubCode

String

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

200

Result.TransactionId

String

認證請求的唯一標識。

4ab0b***cbde97