調用ContrastFaceVerify接口對包含眨眼動作的視頻進行實人認證。
傳入視頻要求
當您在進行實人認證的時候，請保證傳入視頻滿足以下所有條件，否則會返回500報錯。
格式：FFmpeg所支持的格式。例如，MOV、MP4、M4A、3GP及碼率。
屏幕方向：目前不支持橫屏視頻。
動作：視頻中必須包含眨眼動作。
時長：視頻時長小于或者等于5秒，建議為2~3秒。
大小：小于或者等于10 MB。
分辨率：大于或者等于320*480像素，且小于或者等于1080P，即1920*1080像素。
接口說明
接口名：ContrastFaceVerify。
全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）
請求方法：POST和GET。
傳輸協議：HTTPS。
接口說明：通過帶眨眼動作的視頻進行實人認證。
QPS限量：API獨享QPS限量，詳情請參見服務端接口QPS限量說明。
請求參數
名稱 | 類型 | 是否必選 | 描述 | 示例值 |
SceneId | Long | 是 | 認證場景ID。該ID在控制臺創建認證場景后自動生成。關于如何創建認證場景，請參見添加認證場景。 | 100000**** |
OuterOrderNo | String | 是 | 客戶服務端自定義的業務唯一標識，用于后續定位排查問題使用。值最長為32位長度的字母數字組合，請確保唯一。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
ProductCode | String | 是 | 認證方案。 唯一取值：ID_MIN_VIDEO。 | ID_MIN_VIDEO |
CertType | String | 是 | 用戶證件類型。支持的證件類型，請參見方案概述。 不同證件類型，取值均為IDENTITY_CARD。 | IDENTITY_CARD |
CertName | String | 是 | 真實姓名。 | 張三 |
CertNo | String | 是 | 證件號碼。 | 1******************9 |
OssBucketName | String | 是。在以下兩種傳入視頻方式中，選擇其中一種：
說明 如果選擇OSS方式傳入視頻，您必須傳入OssBucketName和OssObjectName參數。OSS請求參數格式僅支持開通實人認證服務時授權的OSS生成的URL、Bucket和Object名稱。 | 已授權OSS空間的Bucket名稱。 | cn-shanghai-aliyun-cloudauth-xxxxx |
OssObjectName | String | 已授權OSS空間的Object名稱。 | verify/xxxxx/xxxxxx.jpeg | |
FaceContrastFileObject | InputStream | 本地視頻文件。 | 具體接入方式，請參見Java SDK調用示例。 | |
Model | String | 否 | 活體檢測類型。取值：
| FRONT_CAMERA_LIVENESS |
DeviceToken | String | 否 | 當前用戶設備的Token，用于風險識別。 | McozS1ZWRcRZStlERcZZo_QOytx5jcgZoZJEoRLO**** |
Mobile | String | 否 | 用戶手機號碼。 | 1390000**** |
Ip | String | 否 | 用戶IP。 | 114.100.XX.XX |
UserId | String | 否 | 客戶業務自定義的用戶ID。 | 148562088256**** |
EncryptType | String | 否 | 加密類型。為空表示不加密。 如開啟加密傳輸，需設置加密算法。目前僅支持SM2國密算法。 如需傳入加密算法，需對CertName和CertNo進行加密，并傳入加密后的密文。有關參數加密的更多信息，請參見參數加密說明。 | SM2 |
返回參數
名稱 | 類型 | 描述 | 示例值 |
RequestId | String | 請求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 |
Message | String | 請求的響應信息。 | success |
Code | String | 返回碼，200指接口響應成功。詳細認證結果判斷，請參見錯誤碼。 | 200 |
ResultObject.Passed | String | 認證結果。取值：
說明 判斷認證結果請以ResultObject.Passed字段為準。 | T |
ResultObject.CertifyId | String | 實人認證請求的唯一標識。 | 08573be80f944d95ac812e019e36**** |
ResultObject.SubCode | String | 認證結果描述，請參見下文ResultObject.SubCode錯誤碼說明。 說明 判斷認證結果請以ResultObject.Passed字段為準。 | 200 |
ResultObject.IdentityInfo | String | 認證的主體信息，目前支持的認證場景返回為空。 | xxx |
ResultObject.MaterialInfo | String | 認證主體附件信息，主要為圖片類材料，JSON格式，請參見ResultObject.MaterialInfo的JSON格式示例。 說明 返回的圖片為url_safebase64編碼，圖片轉換時需要進行相反解碼，即將-、_兩個字符分別替換為+和/。 | {"faceAttack": "F","faceOcclusion":"F","facialPictureFront": {"faceAttackScore": 0.00008597839769208804,"qualityScore": 88.3615493774414,"verifyScore": 50.28594166529785}} |
ResultObject.MaterialInfo的JSON格式示例
{
// 是否為攻擊：攻擊為T，非攻擊為F。
"faceAttack": "F",
// 是否有臉部遮擋：有臉部遮擋為T，否則為F。
"faceOcclusion": "F",
"facialPictureFront": {
// 人臉攻擊分。
"faceAttackScore": 0.00008597839769208804,
// 視頻抽幀質量最佳人臉照片Base64編碼。返回的圖片為url_safebase64編碼，圖片轉換時需要進行相反解碼，即將-、_兩個字符分別替換為+和/。
"pictureBase64": "_9j_4AAQSkZJRgABAQAAAQABAAD_2wX****",
// 活體人臉質量分數。
"qualityScore": 88.3615493774414,
// 人臉和公安比對分數，閾值可參考下表詳細說明。
"verifyScore": 50.28594166529785
}
}表 2. ResultObject.SubCode錯誤碼說明
錯誤碼 | 認證描述文案 | 是否計費 | 可能原因和處理建議 |
200 | 認證通過 | 是 | 成功。 |
201 | 姓名和身份證不一致 | 是 | 可能是用戶的信息有誤或用戶的信息為假信息，建議用戶確認后重新操作。若同一身份信息重新發起認證，服務端初始化將會返回417錯誤。 |
202 | 查詢不到身份信息 | 是 | 可能是用戶戶口遷移等特殊狀態導致，建議預留人工審核入口，進行人工審核。若同一身份信息重新發起認證，服務端初始化將會返回417錯誤。 |
203 | 查詢不到照片或照片不可用 | 是 | 可能是公安庫數據問題導致，建議預留人工審核入口，進行人工審核。若同一身份信息重新發起認證，服務端初始化將會返回417錯誤。 |
204 | 人臉比對不一致 | 是 | 可能不是同一人或活體照片質量較低，建議根據業務情況分層處理，若為同一人可重新操作。 |
205 | 活體檢測存在風險 | 是 | 可能存在攻擊風險，建議人工審核分層處理，若為真人可重新操作。 |
206 | 業務策略限制 | 是 | 為了保證認證的安全性，會對認證的設備、身份、人臉等環境進行安全檢測，若檢測到可能存在風險會判定認證結果不通過。您可以按照如下方法排查處理：
|
表 1. verifyScore閾值說明
千分之一誤識率 | 萬分之五誤識率 | 萬分之一誤識率 | 十萬分之五誤識率 | 十萬分之一誤識率 |
70 | 71.5 | 75 | 76.5 | 80 |
如果您有個性化需求，您可以根據業務情況，參考返回的比對分和閾值，自定義認證結果。
返回Code和Message說明
Code | Message | 描述 |
200 | success | 請求響應成功。 |
400 | 參數不能為空 | 參數不能為空。 |
401 | 參數非法 | 非法參數。傳入的姓名、身份證號碼長度必須符合國家標準且不得包含英文字母等特殊字符。 |
402 | 應用配置不存在 | 應用配置不存在。 |
404 | 認證場景配置不存在 | 認證場景配置不存在，請先在控制臺上添加認證場景。具體操作，請參見添加認證場景。 |
410 | 未開通服務 | 未開通OSS產品或未完成OSS讀寫授權，請登錄控制臺完成授權。具體操作，請參見授權金融級實人認證訪問OSS存儲空間。 |
411 | RAM無權限 | 需要給子賬號授予AliyunAntCloudAuthFullAccess的操作權限。 |
412 | 欠費中 | 金融級實人認證或OSS存在欠費，請充值后操作。 |
417 | 無法使用刷臉服務 | 當前身份信息比對源不可用。若信息正確，建議人工審核。 |
418 | 刷臉失敗次數過多 | 當天刷臉認證次數過多，請在明天再試。 |
419 | 傳入圖片不可用 | 圖片無法下載、圖片內容為空、圖片分辨率不符合要求或提取不到人臉特征，建議更換圖片。 |
420 | 數據重復 | 通過多種方式傳入了認證材料，目前支持以下兩種方式中的一種傳入認證材料：
|
421 | 傳入圖片過大 | 圖片超過了10 MB，建議壓縮圖片或更換圖片上傳方式。 |
422 | 下載圖片超時 | 圖片下載超過了3秒，請排查網絡后重新操作。 |
423 | 狀態錯誤 | 傳入的CertifyId認證狀態需要為T（認證通過），您也可以更換其他方式傳入圖片。 |
430 | 視頻讀取失敗 | 視頻讀取失敗，建議參考視頻要求重新提交。 |
431 | 視頻過大 | 視頻大小超過限制，建議參考視頻要求，壓縮視頻后重新提交。 |
432 | 視頻過長 | 視頻長度超過限制，建議將錄制視頻時長控制在3秒內。 |
433 | 視頻格式不支持 | 視頻格式不支持，參考視頻要求重新提交。 |
434 | 視頻分辨率不符合要求 | 視頻分辨率不支持，參考視頻要求，調整分辨率后提交。 |
435 | 視頻中無人臉 | 視頻中檢測不到人臉，建議參考視頻要求重新提交。 |
500 | 系統錯誤 | 系統內部錯誤，請排查傳入視頻是否符合要求，具體信息，請參見傳入視頻要求。如果視頻符合要求但仍然提示報錯，請聯系工程師處理。 |