ID Verification：FACE_LIVENESS_MIN

介面說明

• 介面名：FaceLivenessV2

• 要求方法：HTTPS POST

• 介面說明：調用FaceLivenessV2介面對人臉圖片進行活體檢測。

• QPS限量：API獨享QPS限量，詳情請參見服務端API QPS限量說明。

• 服務地址：

  說明

  • 內網訪問優勢：內網指阿里雲同一地區內各產品間的私人通訊網路。若您的商務服務器部署於阿里雲對應地區，請使用內網網域名稱訪問 ID Verification 服務，以獲得更安全、穩定的通訊品質。 

  • 海外訪問最佳化建議：海外網路環境複雜，建議參考服務端網路耗時最佳化，最佳化整合方案，降低網路延遲及請求失敗機率。

  中國香港

  • 公網：cloudauth-intl.cn-hongkong.aliyuncs.com

  • 內網：cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

  新加坡

  • 公網：cloudauth-intl.ap-southeast-1.aliyuncs.com

  • 內網：cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

  印尼

  • 公網：cloudauth-intl.ap-southeast-5.aliyuncs.com

  • 內網：cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

  馬來西亞（吉隆坡）

  • 公網：cloudauth-intl.ap-southeast-3.aliyuncs.com

  • 內網：cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com

線上調試和整合

您可以在OpenAPI Explorer中直接運行本介面進行調試，並產生本介面的SDK程式碼範例。

傳入人臉圖片格式要求

• 人像圖片傳入提供三種方式，任選其一即可。

  • Base64模式：FacePictureBase64

  • URL模式：FacePictureUrl

  • 檔案流模式：FacePictureFile

• 圖片格式：JPG、JPEG、PNG。

• 圖片大小：推薦 50~100 KB，最大不超過 1 MB。

• 圖片解析度：不超過 1920*1080（高*寬），至少為 640*480（高*寬），推薦短邊縮放到 720 像素，壓縮率大於 0.9。圖片高大於寬，如果傳入的照片寬大於高，可能會影響檢測效果。

  說明

  圖片轉 base64 格式後，通常會導致資料體積增加。如需要使用 base64 格式傳參，請保證原始圖片的體積不超過 0.6 MB，以滿足 1 MB 的最巨量資料傳輸限制。

• 圖片品質建議：

  • 人臉面部需要完整清晰無遮擋，正對網路攝影機，推薦上傳通過自拍採集的人臉圖片。

  • 人臉大小佔比圖片中面積需要>60%，若人臉較小會影響檢測的準確性。

  • 若圖片中存在多個人臉，演算法預設截取較大的人臉，建議避免傳入多個人臉圖片。

請求參數

返回資料

{
 "faceAttack": "N",
 "faceQualityScore": 88.62,
 "faceOcclusionResult": "N"
}