DocsICP FilingConsole
Documentation
Home Page ID Verification Financial Level Real Person Certification Developer Reference Common reference Face Verification Subject Attachment Information

Face Verification Subject Attachment Information

Updated at:
Copy as MD
Product
My Favorites

MaterialInfo

Return values and fields by solution

Access Type

Product code

Main output for face verification subject materials

Returned fields

ID Verification for Financial Services

App (SDK) integration

ID_PRO

  • 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.

 
{
  "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
  }
}

If multiple photos are configured to return, the facialPictureFront field also returns the following:

"customFaceObjectNameUrls": [
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic1.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D",
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic2.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D"
],
"customFaceObjectNames": [
  "verify/177***150/sha589b06***Pic1.jpeg",
  "verify/177***150/sha589b06***Pic2.jpeg"
]

ID_PLUS

  • 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,
    "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
  }
}

If multiple photos are configured to return, the facialPictureFront field also returns the following:

"customFaceObjectNameUrls": [
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic1.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D",
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic2.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D"
],
"customFaceObjectNames": [
  "verify/177***150/sha589b06***Pic1.jpeg",
  "verify/177***150/sha589b06***Pic2.jpeg"
]

PC or mobile H5 web integration

ID_PRO

  • 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).

  • Anti-spoofing result and attack 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.

 
{
  "faceAttack": "T",
  "faceOcclusion": "F",
  "faceAge":"20",
  "facialPictureFront": {
    "customFaceObjectNameUrls": [
      "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic1.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D",
      "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic2.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D"
    ],
    "customFaceObjectNames": [
      "verify/177***150/sha589b06***Pic1.jpeg",
      "verify/177***150/sha589b06***Pic2.jpeg"
    ],
    "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
  }
}

If multiple photos are configured to return, the facialPictureFront field also returns the following:

"customFaceObjectNameUrls": [
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic1.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D",
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic2.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D"
],
"customFaceObjectNames": [
  "verify/177***150/sha589b06***Pic1.jpeg",
  "verify/177***150/sha589b06***Pic2.jpeg"
]

Server-only (API) integration

ID_MIN (photo-based ID verification)

  • 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 submitted face photo and the authoritative source photo (verifyScore).

    Note

    verifyScore is the matching score between the submitted 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).

 
{
  "faceAttack": "T",
  "faceOcclusion": "F",
  "facialPictureFront": {
    "faceAttackScore": 0.00008597839769208804,
    "qualityScore": 99.93476867675781,
    "qualityBackground": "0",
    "qualityBlur": "0",
    "qualityIllu": "0",
    "qualityOccu": "0",
    "qualityWearHat": "F",
    "verifyScore": 57.678396649466755
  }
}

ID_MIN_VIDEO (video-based ID verification)

  • 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 best frame of the submitted face video and the authoritative source photo (verifyScore).

    Note

    verifyScore is the matching score between the best frame of the submitted face video 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).

  • Face photo in Base64 format.

 
{
  "faceAttack": "F",
  "faceOcclusion": "F",
  "facialPictureFront": {
    "faceAttackScore": 0.00008597839769208804,
    "qualityScore": 88.3615493774414,
    "qualityBackground": "0",
    "qualityBlur": "0",
    "qualityIllu": "0",
    "qualityOccu": "0",
    "qualityWearHat": "F",
    "verifyScore": 50.28594166529785,
    "pictureBase64": "_9_4SALJIDFLNEL..."
  }
}

Financial-grade face liveness verification

App (SDK) integration

PV_FV

  • 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).

  • Result and score of face attack detection (faceAttack/faceAttackScore)

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

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

    Note

    verifyScore is the matching score between the liveness face photo and the submitted face photo.

  • OSS storage location and URL of the face photo (materials 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/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...",
    "guardRiskScore":20
  }
}

If multiple photos are configured to return, the facialPictureFront field also returns the following:

"customFaceObjectNameUrls": [
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic1.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D",
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic2.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D"
],
"customFaceObjectNames": [
  "verify/177***150/sha589b06***Pic1.jpeg",
  "verify/177***150/sha589b06***Pic2.jpeg"
]

H5 web integration

PV_FV

  • 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 Attack Detection Result and Attack Score (faceAttack/faceAttackScore)

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

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

    Note

    verifyScore is the matching score between the liveness face photo and the submitted face 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/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...",
    "guardRiskScore":20
  }
}

If multiple photos are configured to return, the facialPictureFront field also returns the following:

"customFaceObjectNameUrls": [
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic1.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D",
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic2.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D"
],
"customFaceObjectNames": [
  "verify/177***150/sha589b06***Pic1.jpeg",
  "verify/177***150/sha589b06***Pic2.jpeg"
]

Financial-grade liveness detection

App (SDK) integration

LR_FR

  • 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 attack detection: result and score (faceAttack/faceAttackScore)

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

  • 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",
    "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...",
    "guardRiskScore":20
  }
}

If multiple photos are configured to return, the facialPictureFront field also returns the following:

"customFaceObjectNameUrls": [
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic1.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D",
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic2.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D"
],
"customFaceObjectNames": [
  "verify/177***150/sha589b06***Pic1.jpeg",
  "verify/177***150/sha589b06***Pic2.jpeg"
]

PC or mobile H5 web integration

LR_FR

  • 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).

  • Anti-spoofing detection results and attack score (faceAttack/faceAttackScore)

  • Face occlusion detection result and quality score, plus detailed quality fields.

  • 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",
    "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...",
    "guardRiskScore":20
  }
}

If multiple photos are configured to return, the facialPictureFront field also returns the following:

"customFaceObjectNameUrls": [
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic1.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D",
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic2.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D"
],
"customFaceObjectNames": [
  "verify/177***150/sha589b06***Pic1.jpeg",
  "verify/177***150/sha589b06***Pic2.jpeg"
]

Server-only (API) integration

LR_FR_MIN

  • Face attack detection result and score (faceAttack/faceAttackScore)

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

 
{
  "faceAttack": "T",
  "faceOcclusion": "F",
  "facialPictureFront": {
    "faceAttackScore": 0.00008597839769208804,
    "qualityScore": 99.93476867675781,
    "qualityBackground": "0",
    "qualityBlur": "0",
    "qualityIllu": "0",
    "qualityOccu": "0",
    "qualityWearHat": "F"
  }
}

Financial-grade Multi-Factor Intent-Based Authentication Solution

App (SDK) integration

MFVC

  • Face liveness verification result and score (faceAttackScore).

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

  • Intent verification content.

  • OSS storage location and URL of the face photo.

    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",
  "facialPictureFront": {
    "faceAttackScore": 0.00008597839769208804,
    "qualityScore": 99.93476867675781,
    "qualityBackground": "0",
    "qualityBlur": "0",
    "qualityIllu": "0",
    "qualityOccu": "0",
    "qualityWearHat": "F",
    "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..."
  },
  "voluntaryCertInfo": {
    "asrTexts": [
      "I agree to process XXX service.",
      "I agree to process XXX service.",
      "I agree to process XXX service."
    ],
    "ossBucketName": "cn-shanghai-aliyun-cloudauth-1260051251634779",
    "voiceOssObjectNames": [
      "verify/1234567890/sha8d374f73c461a00e0****_wish_voice_0.wav",
      "verify/1234567890/sha8d374f73c461a00e0****_wish_voice_1.wav",
      "verify/1234567890/sha8d374f73c461a00e0****_wish_voice_2.wav"
    ],
    "voiceUrls": [
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_voice_0.wav?security-token=CAISjgJ1q6...",
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_voice_1.wav?Expires=1625371365&OSSAccessKeyId=STS.NTEz8oi35qJpxxX7no5gpGd****&Signature=wnHjNu3333ddW3zNMup1r4ovgrw6xJ0****&security-token=CAISjgJ1q6...",
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_voice_2.wav?security-token=CAISjgJ1q6F..."
    ],
    "screenVideoOssObjectNames": [
      "verify/1234567890/sha8d374f73****_wish_video_0.mov",
      "verify/1234567890/sha8d374f73****_wish_video_1.mov",
      "verify/1234567890/sha8d374f73****_wish_video_2.mov"
    ],
    "screenVideoUrls": [
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_video_0.mov?security-token=CAISjgJ1q6Ft...",
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_video_1.mov?security-token=CAISjgJ1q6...",
      "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/sha8d374f73c461a00e029def92c5c4c_wish_video_2.mov?security-token=CAISjgJ1q6..."
    ]
  }
}

If multiple photos are configured to return, the facialPictureFront field also returns the following:

"customFaceObjectNameUrls": [
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic1.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D",
  "https://cn-shanghai-aliyun-cloudauth-177***150.oss-cn-shanghai.aliyuncs.com/verify/177***150/sha58***Pic2.jpeg?Expires=17***9&OSSAccessKeyId=STS.NZtBj***SFWN&Signature=8%2***IKRZFdgsY%3D&security-token=CAIS2w***A%3D"
],
"customFaceObjectNames": [
  "verify/177***150/sha589b06***Pic1.jpeg",
  "verify/177***150/sha589b06***Pic2.jpeg"
]

Financial-grade NFC authentication solution

App (SDK) integration

NFC_QY

  • Certificate element information.

  • Identification photo

 
{
  "passportInfo": {
    "birthDate": "87****",
    "countryCode": "C**",
    "enName": " **** H**",
    "endTime": "29****",
    "idNum": "E*******2",
    "machineReadCode": "POCHN***",
    "name": "**",
    "nationality": "C**",
    "otherIdNum": "",
    "otherName": "P*NG,HUI",
    "sex": "M",
    "signingTimes": ""
  },
  "passportPictureFront": {
    "ossBucketName": "cn-shanghai-aliyun-cloudauth-xxxx",
    "ossPassportFaceObjectName": "verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cd_passport_picture.jpg",
    "ossPassportFaceUrl": "https://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cd_passport_picture.jpgxxx",
    "ossPassportObjectName": "verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cd_passport_image.jpg",
    "ossPassportUrl": "https://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cdxxx"
  }
}

verifyScore thresholds

0.1% false acceptance rate

0.05% false acceptance rate (recommended)

0.01% false acceptance rate

0.005% false acceptance rate

0.001% false acceptance rate

0.0001% false acceptance rate

70

71.5

75

76.5

80

85
Note

If you have custom requirements, you can define your own verification results using the returned matching scores and thresholds.

Face quality field descriptions

Field name

Description

Values

qualityScore

Liveness face quality score.

0–100 (recommended minimum: 70)

qualityBlur

Blur level.

  • 0: Clear

  • 1: Slightly blurred

  • 2: Slight to moderate

  • 3: Moderate

  • 4: Moderate to severe

  • 5: Severe

qualityOccu

Occlusion level.

  • 0: No occlusion

  • 1: Slight occlusion

  • 2: Slight to moderate

  • 3: Moderate

  • 4: Moderate to severe

  • 5: Severe

qualityIllu

Illumination level.

  • 0: Normal illumination

  • 1: Too dark

  • 2: Overexposed

  • 3: Uneven illumination

  • 4: Other illumination anomalies

qualityWearHat

Whether a helmet is worn.

  • T: Helmet worn

  • F: No helmet

qualityBackground

Background darkness level.

  • 0: Normal background

  • 1: Slightly dark

  • 2: Slight to moderate

  • 3: Moderate

  • 4: Moderately severe

  • 5: Severe
Previous：Device risk tagsNext：Device Assistant value-added service