ID Verification:FACE_LIVENESS_MIN.

API description

• API name: FaceLivenessV2

• Request method: HTTPS POST

• Performs liveness detection on face images.

• QPS limit: Each API has a dedicated QPS limit. For details, see QPS limits of ID Verification server-side APIs.

• Service endpoint:

  Note

  • Benefits of internal network access: An internal network enables private communication between Alibaba Cloud services in the same region. If your application server is also in the same region, use the internal network endpoint to access the ID Verification service for a more secure and stable connection. 

  • Optimization for overseas access: Network conditions outside the Chinese mainland can be complex. To reduce latency and minimize request failures, optimize your integration by following the best practices in Server-side Network Latency Analysis and Optimization.

  China (Hong Kong)

  • Public endpoint: cloudauth-intl.cn-hongkong.aliyuncs.com

  • Internal endpoint: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

  Singapore

  • Public endpoint: cloudauth-intl.ap-southeast-1.aliyuncs.com

  • Internal endpoint: cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

  Indonesia (Jakarta)

  • Public endpoint: cloudauth-intl.ap-southeast-5.aliyuncs.com

  • Internal endpoint: cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

  Malaysia (Kuala Lumpur)

  • Public endpoint: cloudauth-intl.ap-southeast-3.aliyuncs.com

  • Internal endpoint: cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com

Online debugging and integration

You can use OpenAPI Explorer to directly run this API for debugging, and generateSDK Code Samples.

Face image format requirements

• Submit face images using one of three methods:

  • Base64 mode: FacePictureBase64

  • URL mode: FacePictureUrl

  • File stream mode: FacePictureFile

• Image format: JPG, JPEG, PNG.

• Image size: Recommended 50–100 KB, maximum 1 MB.

• Image resolution: Maximum 1920*1080 (height × width), minimum 640*480 (height × width). Scale the shorter side to 720 px with compression ratio > 0.9. Height must exceed width; landscape orientation may reduce accuracy.

  Note

  Base64 encoding inflates file size. Keep the original image under 0.6 MB to stay within the 1 MB transfer limit.

• Image quality recommendations:

  • Face must be complete, clear, unobstructed, and front-facing. Use a front-facing camera.

  • Face must occupy more than 60% of the image area. Smaller faces reduce accuracy.

  • Multiple faces: the algorithm processes the largest one. Avoid multi-face images.

Request parameters

Response parameters

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