# 版本

5.0.0

# 描述

此接口上传待核验人员相关信息，从而获取对应活体验证结果。

# 调用URL

新加坡：https://api-sgp.megvii.com/faceid/v5/sdk/liveness
印尼地区：https://api-idn.megvii.com/faceid/v5/sdk/liveness

注意：在生产环境中，请使用 HTTPS 的通信方式。HTTP 方式的通信属于不安全链路，存在安全风险，请勿在生产环境中使用。在生产环境中使用 HTTP 方式的，将无法得到服务可靠性保障。

# 调用方法

POST  注意：用 form-data 格式请求

# 权限

仅当用户接入FaceID产品后，才能调用FaceID各Web API。接入FaceID的流程请咨询FaceID商务人员。

# 参数

# 返回值说明

# 返回值示例

正确请求返回示例

{
   "request_id":"1531397565,39b19451-393c-4fc4-8fae-6dc74b2b00d7",
   "biz_no":"",
   "time_used":1448,
   "user_faced_time":"1699422077",
   "result_code":1000,
   "result_message":"SUCCESS",
   "attack_result":{
      "score":0.26,
      "threshold":0.5,
      "result":False
   },
   "device_risk_info":{
      "device_info_level": "2",
      "device_info_tags": {"is_root":0,"is_hook":1,"is_injection":1,"is_virtual_environment":1}
   },
   "face_risk_info":{
      "face_info_tags":{"is_photo":0,"is_screen_remake":1,"is_paper_cut":0,"is_paper_mask":0,"is_3d_mask":0,"is_facial_mask":0,"is_software_composition":0,"is_eye_close":0,"is_change_face":0,"other":0}
   },
   "images":{
      "image_best":"xxxxxxxxxxx"
   },
   "video_key":"asdffff",
   "visual_attributes":{
      "age":16,
      "gender":0
   },
   "face":{
      "quality":38.221,
      "quality_threshold":30.1,
      "rect":{
         "left":0.18,
         "top":0.18,
         "width":0.596,
         "height":0.596
       },
      "orientation":90
   }
}

失败请求返回示例

{
    "error": "AUTHORIZATION_ERROR: INVALID_SIGN"
}

# result_code & result_message 对照表

# 错误码列表