人臉靜默活體（LivenessFaceVerify）指通過API接口傳入提前獲取的人臉圖片進行真實人臉檢測的服務。其算法主要識別人臉是否為屏幕翻拍、打印圖片等活體攻擊類型。該服務適用于低風險業務場景或配合離線人臉識別SDK使用。若您的業務對真實人臉安全要求較高，推薦您集成App或者WebSDK模式或者集成人臉Deepfake檢測服務，輔助識別更多維度人臉偽造風險。
傳入圖片要求
為了確保模型效果穩定，您需要保證傳入的圖片中只有一張人臉，且該人臉的角度正常。此外，還需要滿足以下條件：
圖片格式：JPG，JPEG。
圖片大小：推薦50~100KB，最大不超過1 MB。
圖片分辨率：建議640*480（高*寬），不超過1920*1080（高*寬），且保持照片的高大于寬。推薦短邊縮放到720像素，壓縮率0.8。
圖片質量：照片清晰、曝光正常，臉部無過黑、過亮、光暈等情況。
接口說明
接口名：LivenessFaceVerify。
全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）
請求方法：POST和GET。
傳輸協議：HTTPS。
接口說明：調用LivenessFaceVerify接口對人臉圖片進行活體檢測。
QPS限量：API獨享QPS限量，詳情請參見服務端接口QPS限量說明。
請求參數
名稱 | 類型 | 是否必選 | 描述 | 示例值 |
SceneId | Long | 是 | 認證場景ID。該ID在控制臺創建認證場景后自動生成。關于如何創建認證場景，請參見添加認證場景。 | 100000**** |
OuterOrderNo | String | 是 | 客戶服務端自定義的業務唯一標識，用于后續定位排查問題。取值最長為32位長度的字母數字組合，請確保唯一。 | e0c34a77f5ac40a5aa5e6ed20c353888 |
ProductCode | String | 是 | 固定值：LR_FR_MIN。 | LR_FR_MIN |
FaceContrastPicture | String | 是 金融級活體檢測方案純服務端接入提供以下三種傳入人臉照片的方式，請您選擇其中一種。
| 照片Base64編碼。 | /9j/4AAQSkZJRgABAQAASxxxxxxx |
FaceContrastPictureUrl | String | 人臉圖片地址，公網可訪問的HTTP、HTTPS鏈接。 | https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg | |
OssBucketName | String | 傳入OSS存儲空間（Bucket）名。需確保與授權OSS時的Bucket名一致。 | cn-shanghai-aliyun-cloudauth-xxxxx | |
OssObjectName | String | 傳入OSS中照片的具體文件名。您可以登錄OSS管理控制臺，在目標文件的詳情面板復制文件名。 | verify/xxxxx/xxxxxx.jpeg | |
Model | String | 否 | 活體檢測類型。取值：
| FRONT_CAMERA_LIVENESS |
DeviceToken | String | 否 | 設備Token，用于風險識別。 | McozS1ZWRcRZStlERcZZo_QOytx5jcgZoZJEoRLOxxxxxxx |
Mobile | String | 否 | 用戶手機號碼。 | 130xxxxxxxx |
Ip | String | 否 | 用戶網絡IP地址。 | 114.xxx.xxx.xxx |
UserId | String | 否 | 客戶業務自定義的用戶ID，請保持唯一。 | 123456789 |
Crop | String | 否 | 是否允許裁剪人臉圖片，默認不允許。
說明
| T |
返回數據
名稱 | 類型 | 描述 | 示例值 |
RequestId | String | 請求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 |
Message | String | 返回信息的響應消息。 | success |
Code | String | 返回碼。返回200表示響應成功。其他返回碼說明，請參見返回Code和Message說明。 詳細認證結果判斷請參考ResultObject.SubCode的結果。 | 200 |
ResultObject.Passed | String | 認證結果。取值：
| T |
ResultObject.CertifyId | String | 實人認證請求的唯一標識。 | 08573be80f944d95ac812e019e3655a |
ResultObject.SubCode | String | 認證結果描述。具體請參見ResultObject.SubCode錯誤碼說明。 | 200 |
ResultObject.MaterialInfo | String | 認證主體附件信息，主要為圖片類材料，JSON格式。 | { // 是否為攻擊。T表示是，F表示否。 \"faceAttack\":\"F\", // 是否有臉部遮擋。T表示是，F表示否。 \"faceOcclusion\":\"F\", \"facialPictureFront\":{ // 人臉攻擊分。 \"faceAttackScore\":0.3212890625, // 活體人臉質量分數。 \"qualityScore\":12.98420429229736 } } |
返回Code和Message說明
Code | Message | 描述 |
200 | success | 成功。 |
400 | 參數不能為空 | 參數不能為空。 |
401 | 參數非法 | 非法參數。傳入的姓名、身份證號碼長度必須符合國家標準且不得包含英文字母等特殊字符。 |
404 | 認證場景配置不存在 | 認證場景配置不存在，請先在控制臺上創建認證場景。 |
410 | 未開通服務 | 未開通OSS產品或未完成OSS讀寫授權，請登錄控制臺完成授權。具體操作，請參見授權金融級實人認證訪問OSS存儲空間。 |
411 | RAM無權限 | 需要為子賬號授予AliyunAntCloudAuthFullAccess的操作權限。 |
412 | 欠費中 | 金融級實人認證或OSS存在欠費，請充值后操作。 |
419 | 傳入圖片不可用 | 圖片無法下載、圖片內容為空、圖片分辨率不符合要求或提取不到人臉特征，建議更換圖片。 |
420 | 數據重復 | 圖片傳入方式超過了一種。支持以下三種傳入人臉圖片的方式，只能使用其中一種：
|
421 | 傳入圖片過大 | 圖片超過了1 MB，建議壓縮圖片或更換圖片上傳方式。 |
422 | 下載圖片超時 | 圖片下載超過了3秒，請排查網絡后重新操作。 |
500 | 系統錯誤 | 系統內部錯誤，請反饋工程師排查。 |
ResultObject.SubCode錯誤碼說明
錯誤碼 | 認證描述文案 | 是否計費 | 可能原因和運營建議 |
200 | 認證通過 | 是 | 無。 |
205 | 活體檢測存在風險 | 是 | 可能存在攻擊風險，建議人工審核分層處理。如果是真人，可重新操作。 |