DescribeFaceVerify - Retrieve authentication results

• Predicted age and gender from the face image (faceAge/faceGender). Prediction may fail and return no value.

• Device risk score predicted by device-level algorithms (guardRiskScore). A higher score indicates higher device risk (range: 0–100).

• Face liveness verification result and score (faceAttack/faceAttackScore).

• Face occlusion detection result and quality score (faceOcclusion/qualityScore), plus detailed quality fields.

• Matching score between the face photo and the authoritative source photo (verifyScore).

  Note

  verifyScore is the matching score between the liveness face photo and the authoritative source photo.

  Due to authoritative source adjustments, the authority matching score may not be returned or may be unreliable. It is recommended to rely on the final authentication result (SubCode).

• OSS storage location and URL of the face photo (video optional).

  Fields for face photo materials and verification video materials are returned based on different configuration items, as follows:

  • The fields related to facial photos (ossBucketName, ossObjectName, pictureUrl) are returned based solely on the configuration in the console authentication scenario:

    • In the console Verification scenario, enable Retain verification materials.

    • OSS authorization is configured and enabled in the console.

  • The video authentication fields (verifyVideoUrl and ossVerifyVideoObjectName) are returned only if all the following conditions are met:

    • In the console Verification scenario, enable Retain verification materials.

    • OSS authorization is configured and enabled in the console.

    • The client configures video return in the extParams parameter (for WebSDK, explicitly configure video-return fields in InitFaceVerify).

  Note

  By default, only the best face photo is returned. To return multiple photos, see Add a verification scenario for configuration.

• Predicted age and gender from the face image (faceAge/faceGender). Prediction may fail and return no value.

• Device risk score predicted by device-level algorithms (guardRiskScore). A higher score indicates higher device risk (range: 0–100).

• Face liveness verification result and score (faceAttack/faceAttackScore).

• Face occlusion detection result and quality score (faceOcclusion/qualityScore), plus detailed quality fields.

• Matching score between the face photo and the authoritative source photo (verifyScore).

  Note

  verifyScore is the matching score between the liveness face photo and the authoritative source photo.

  Due to authoritative source adjustments, the authority matching score may not be returned or may be unreliable. It is recommended to rely on the final authentication result (SubCode).

• Matching score between the face photo and the ID card photo (idCardVerifyScore).

  Note

  idCardVerifyScore is the matching score between the liveness face photo and the ID card photo.

• OCR-extracted information and OSS storage location and URL of the ID card photo.

• OSS storage location and URL of the face photo (video optional).

  Fields for face photo materials and verification video materials are returned based on different configuration items, as follows:

  • The fields related to facial photos (ossBucketName, ossObjectName, pictureUrl) are returned based solely on the configuration in the console authentication scenario:

    • In the console Verification scenario, enable Retain verification materials.

    • OSS authorization is configured and enabled in the console.

  • The video authentication fields (verifyVideoUrl and ossVerifyVideoObjectName) are returned only if all the following conditions are met:

    • In the console Verification scenario, enable Retain verification materials.

    • OSS authorization is configured and enabled in the console.

    • The client configures video return in the extParams parameter (for WebSDK, explicitly configure video-return fields in InitFaceVerify).

  Note

  By default, only the best face photo is returned. To return multiple photos, see Add a verification scenario for configuration.

{
  "faceAttack": "T",
  "faceOcclusion": "F",
  "faceAge":"20",
  "facialPictureFront": {
    "faceAttackScore": 0.00008597839769208804,
    "qualityScore": 99.93476867675781,
    "qualityBackground": "0",
    "qualityBlur": "0",
    "qualityIllu": "0",
    "qualityOccu": "0",
    "qualityWearHat": "F",
    "Gender":"M",
    "verifyScore": 57.678396649466755,
    "ossBucketName": "cn-shanghai-aliyun-cloudauth-12600*********",
    "ossObjectName": "verify/1260***4779/03a08********.jpeg",
    "pictureUrl": "http://cn-shanghai-aliyun-cloudauth-1260***4779.oss-cn-shanghai.aliyuncs.com/verify/1260***4779/03a081********.jpeg?&security-token=CAISjgJ1q6Ft...",
    "ossVerifyVideoObjectName": "verify/1260***4779/03a081****_verifyvideo_dcb7.mov",
    "verifyVideoUrl": "http://cn-shanghai-aliyun-cloudauth-1260***4779.oss-cn-shanghai.aliyuncs.com/verify/1260***4779/03a08150c57__********.mov?security-token=CAISjgJ1q6Ft...",
    "guardRiskScore":20
  }
}

{
  "faceAttack": "T",
  "faceOcclusion": "F",
  "faceAge":"20",
  "facialPictureFront": {
    "faceAttackScore": 0.00008597839769208804,
    "qualityScore": 99.93476867675781,
    "qualityBackground": "0",
    "qualityBlur": "0",
    "qualityIllu": "0",
    "qualityOccu": "0",
    "qualityWearHat": "F",
    "Gender":"M",
    "verifyScore": 57.678396649466755,
    "idCardVerifyScore": 50.99797734769861,
    "ossBucketName": "cn-shanghai-aliyun-cloudauth-12600*********",
    "ossObjectName": "verify/1260051251634779/03a081bd96328aedf83f635f3********.jpeg",
    "pictureUrl": "http://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/1260051251634779/03a081bd96328aedf83f635f********.jpeg?&security-token=CAISjgJ1q6Ft...",
    "ossVerifyVideoObjectName": "verify/1260051251634779/03a081bd96328aedf83f635****_verifyvideo_dcb7.mov",
    "verifyVideoUrl": "http://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/1260051251634779/03a081bd96328aedf83f635f39a50c57__********.mov?security-token=CAISjgJ1q6Ft..."
  },
  "ocrIdCardInfo": {
    "address": "XXX Province, XX City, XXX District, XX Street, X No.",
    "authority": "XXX Public Security Bureau, XXX Branch",
    "birth": "20010213",
    "certName": "Mr. Zhang",
    "certNo": "4****************X",
    "endDate": "20450523",
    "nationality": "Han",
    "sex": "Male",
    "startDate": "20250523"
  },
  "ocrPictureFront": {
    "ossBucketName": "cn-shanghai-aliyun-cloudauth-12********",
    "ossIdFaceObjectName": "verify/1234567890/f7ed1ef80ad1234fdsd95c********cd_ocridface_b749.jpeg",
    "ossIdFaceUrl": "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridface_b749.jpeg?security-token=CAISjdfgeJ1q6F...",
    "ossIdNationalEmblemObjectName": "verify/1234567890/f7ed1ef80ad1234fdsd95c********cd_ocridnationalemblem_a3hf.jpeg",
    "ossIdNationalEmblemUrl": "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridnationalemblem_a3hf.jpeg?security-token=CAISjgJ1q6...",
    "guardRiskScore":20
  }
}