• “1”表示KYC验证比对，将与参考照片进行比对。以下的“二选一”参数组里，必须使用“KYC验证时”参数组，否则可能返回错误码400（MISSING_ARGUMENTS）。此外，如果没有“KYC验证”的权限，也不能设置此参数为“1”，否则返回错误码 403（AUTHORIZATION_ERROR:“No data source permission.”）
• “0”表示人脸比对，FaceID将使用用户自己提供的照片（参数image_ref[x]）作为比对人脸照。以下的“二选一”参数集里，必须使用“人脸比对时”参数组，否则可能返回错误码400（MISSING_ARGUMENTS）

• “meglive”，表示本次比对照为从FaceID活体检测SDK MegLive 中生成的最优照片。以下的“比对图片 四选一”参数组里，必须使用“配合MegLive SDK使用时”这一组参数，否则可能返回错误码400（MISSING_ARGUMENTS）

• “facetoken”，表示本次比对时，用户已经调用了FaceID的detect方法从原始图片中检测出人脸，用一个facetoken表示，然后将这个facetoken作为待比对的人脸。以下的“比对图片 四选一””参数组里，必须使用“调用detect后获得facetoken时”这一组参数，否则可能返回错误码400（MISSING_ARGUMENTS）

• “raw_image”，表示本次比对时，用户直接上传一张可能包含人脸的图片作为待比对的图片，FaceID将先检测图中人脸然后将人脸与参照脸比对。以下的“比对图片 四选一””参数组里，必须使用“直接上传一张照片时”这一组参数，否则可能返回错误码400（MISSING_ARGUMENTS）

• “meglive_flash”，表示本次比对的照片为从 FaceID 炫彩活体 SDK MegLiveFlash 中生成的照片。以下的“四选一”参数组里，必须使用“配合MegLiveFlash SDK使用时”这一组参数，否则可能返回错误码400（MISSING_ARGUMENTS） 

多张由您自己提供的参照人脸照片。x表示此参数可重复多次，其中1<= x <= 3，即表示可以传最多三张参照人脸照片（参数分别为image_ref1, image_ref2, image_ref3）。在KYC验证时使用这个参数，主要目的是让待验证照和您从其他渠道获得的参考照片比对（如果您有）

如果在image_ref1、image_ref2、image_ref3中的任一张图片里没有找到人脸，将返回错误码400（NO_FACE_FOUND)；如果这些图片中任一张中有多张脸，将返回错误码400（MULTIPLE_FACES）

• “1”: 立即返回错误码400（MULTIPLE_FACES）
• “0”：取最大脸继续比对
• 其他值：返回错误码400（BAD_ARGUMENTS）

多张由您自己提供的参照人脸照片。x表示此参数可重复多次，其中1<=x <= 3，即表示可以传最多三张参照人脸照片（参数分别为image_ref1, image_ref2, image_ref3）

如果在image_ref1、image_ref2、image_ref3中的任一张图片里没有找到人脸，将返回错误码400（NO_FACE_FOUND)；如果这些图片中任一张中有多张脸，将返回错误码400（MULTIPLE_FACES）

• “1”: 立即返回错误码400（MULTIPLE_FACES）
• “0”：取最大脸继续比对
• 其他值：返回错误码400（BAD_ARGUMENTS）

用于假脸判定，请传MegLive SDK返回的用作云端假脸攻击判定的照片，FaceID将使用image_env进行假脸判定，完整返回face_genuineness对象中的所有字段

注意：此参数需要MegLive SDK 2.4.1版本以及更新的版本配合支持，低于2.4.1版本的MegLive SDK不返回这张照片

• “1”：当使用此参数且delta已使用过时，将返回错误信息400（DELTA_USED）
• “0”：忽略delta是否使用过
•  其他值：返回400（BAD_ARGUMENTS）

• “1”: 立即返回错误码400（MULTIPLE_FACES）
• “0”：取最大脸继续比对
• 其他值：返回错误码400（BAD_ARGUMENTS）

• “1”: 返回人脸检测结果(faces)
• “0”：不返回
• 其他值：返回错误码400（BAD_ARGUMENTS）

•  用于初始化 SDK 的 meglive_biz_no
•  经过算法处理的图像
•  活体过程中的日志信息

• 如果该参数传入的内容发生损坏、非炫彩活体输出、或是在失败时的输出，则返回 400（BAD_ARGUMENTS）
• 在输入有问题的参数文件时，亦会返回 400（MEGLIVE_BIZ_NO_USED）错误
• 上传文件的大小一般在 50KB 左右
• 在调用 verify 接口后，可以通过 meglive_biz_no 在 get_biz_info 接口中请求到图像、活体失败信息

• “1”：启用旋转检测（启用旋转检测后，会增加API的调用时间）
• “0”：不启用旋转检测
• 其他值：返回错误码400（BAD_ARGUMENTS）

• "confidence"：Float类型，取值［0，100］，数字越大表示风险越小。
• “thresholds”：一组用于参考的置信度阈值，Object类型，包含四个字段，均为Float类型、取值［0，100］：
  • “1e-3”：风险为千分之一的置信度阈值
  • “1e-4”：风险为万分之一的置信度阈值
  • “1e-5”：风险为十万分之一的置信度阈值
  • “1e-6”：风险为百万分之一的置信度阈值

注意：阈值不是静态的，每次比对返回的阈值不保证相同，所以没有持久化保存阈值的必要，更不要将当前调用返回的confidence与之前调用返回的阈值比较

关于阈值选择，以下建议仅供参考：

• 阈值选择主要参考两个因素：业务对安全的要求和对用户体验的要求。严格的阈值对应更高的安全度，但是比对通过率会下降，因此更容易出现用户比对多次才通过的情况，用户体验会有影响；较松的阈值带来一次通过率会提升，用户体验更好，但是出现非同一个人的概率会增大，安全性会有影响。请按业务需求偏好慎重选择
• “1e-3”阈值是较松的阈值。如果confidence低于“1e-3”阈值，我们不建议认为是同一个人；如果仅高于“1e-3”阈值，勉强可以认为是同一个人。这个阈值主要针对对安全性要求较低的场景（比如在分项业务有独立密码保护的情况下刷脸登陆app），或者原则上安全性要求高、但在一个具体流程里如果发生安全事故后果不严重的场景（比如“转账”场景安全性要求高、但是当前转账的金额很小）
• “1e-5”、“1e－6”阈值都是较严格的阈值，一般来说置信度大于“1e-5”阈值就可以相当明确是同一个人。我们建议使用“1e-5”到关键的、高安全级别业务场景中，比如大额度的借款或者转账。“1e-6”则更加严格，适用于比较极端的场景
• “1e-4”阈值的严格程度介于上述两项之间
• 如果对阈值选择存疑，请咨询FaceID商务或技术支持团队

此对象包含的字段与result_faceid的一致，请参考对应的描述

此字段只在接口被成功调用时返回

本对象返回身份相关的异常情况，如证件号码是否曾被冒用来攻击FaceID活体检测、参考数据人像照片是否存在质量不佳等问题。调用者可通过此对象增进对比对结果的解读

• "id_attacked"：Int类型，判别证件号码是否曾被冒用来攻击FaceID活体检测，取值1表示曾被攻击、取值0表示未被攻击。攻击形态包括但不限于戴面具、换人攻击、软件3D合成人脸等手段。若被判别为“是”，则有可能这个证件证号码目前存在被利用的风险。注意：判别为“是”不意味身份持有者本人参与攻击，有可能其身份被他人盗用而本人无感知
• "id_photo_monochrome"：Int类型，参考数据人像照片的色彩判断，取值1表示是黑白照片、取值0表示是彩色照片。参考数据存在一部分人像照片是黑白的现象，黑白的照片会影响比对质量，一般来说将降低比对分数。本字段表达这样的异常

当待比对照片为未经detect方法检测过的照片、且return_faces参数为1时，返回本字段。本字段包含了一张或多张脸的人脸检测信息，包括人脸位置和人脸图像质量。此字段只在接口被成功调用时返回，请见参数return_faces的说明了解相关的出错情况

faces对象包含一系列人脸检测结果，每个结果包含如下字段：

• "quality"：Float类型，表示检测出的一张人脸图像的质量，取值［0，100］，越高越好
• “quality_threshold”：Float类型，取值［0，100］，表示FaceId建议的人脸图像质量阈值，大于此阈值可以认定图像质量足够完成比对
• "rect"：这是一个Object，表示检测出的一张人脸在原始图像中的包围盒。它包含left、top、width、height四个Float类型字段来表示坐标，均取值［0，1］，小数点后数字不限3位。left、top分别表示此包围盒的左上角相对于原始图像左上角的位置的比例，width、height分别表示此包围盒相对原始图像的宽、高的比例，比如 left =0.5、top=0.5、width =0.5、height＝0.5 表示该包围盒的左上角是图像正中心，右下角是图像的右下角
• orientation：Int类型，本字段仅在参数 multi_oriented_detection为“1”时才返回，表示人脸框的朝向，目前仅取0、90、180或270，单位为度，按顺时针方向。以人脸来说，0度表示通常意义上的正向、90度为头顶朝右下巴朝左、180度表示上下颠掉、270度表示头顶朝左下巴朝右。按此角度逆时针旋转图片即可获得正向的人像照

该字段表示待比对的脸的真实性。“真实的人脸”是指待比对的人脸图像是真实人脸的拍摄，而不是戴面具的脸、通过软件人工合成的脸、或是屏幕翻拍回放的脸。本字段返回真实性检查结果以及用作参考的相关阈值

仅当待比对照为来自MegLive模块时（face_image_type == "meglive" OR "meglive_flash"）才返回此对象。本对象包括如下字段：

• synthetic_face_confidence：Float类型，取值［0，1］，表示人脸照片为软件合成脸的置信度
• synthetic_face_threshold：Float类型，取值［0，1］，表示人脸照片为软件合成脸的置信度阈值。 如果synthetic_face_confidence < synthetic_face_threshold，可以认为人脸不是软件合成脸

• mask_confidence：Float类型，取值［0，1］，表示人脸照片为面具的置信度
• mask_threshold：Float类型，取值［0，1］，表示人脸照片为面具的置信度阈值。 如果mask_confidence < mask_threshold，可以认为人脸不是面具

• screen_replay_confidence：Float类型，取值［0，1］，表示人脸照片为屏幕翻拍的置信度。注意：此字段只有在调用时传入了image_env参数才返回
• screen_replay_threshold：Float类型，取值［0，1］，表示人脸照片为屏幕翻拍的置信度阈值。 如果screen_replay_confidence < screen_replay_threshold，可以认为人脸不是屏幕翻拍。注意：此字段只有在调用时传入了image_env参数才返回（face_image_type == "meglive_flash" 不返回此字段）

• face_replaced：Int类型，只取值0或1。0表示未检测出换脸攻击，1表示检测出了换脸攻击。注意：换脸攻击的检测需要MegLive SDK 2.4.3以上版本配合，仅当在移动端上使用的活体SDK版本不低于2.4.3或为炫彩活体时，才返回该字段，否则不返回该字段

• 当<param>取值为data_source时，表示参考数据返回的图片无法解析、或者没有照片。注意：这对应Verify 1.0 API里的错误码 400（IDCARD_NO_PHOTO）
•  当<param>取其他值时对应相应的参数

• 当KYC验证时，如果参考数据没有指定人的图像、或者图像里没有检测到人脸，参数<param>值为data_source
• 当image中没有人脸时，参数<param>值为image
• 当image_ref1、image_ref2、image_ref3中没有人脸时，参数<param>分别返回各自的参数名

客户上传的图像太大。具体是指图像存储尺寸超过2MB、或者像素尺寸的长或宽超过4096像素。<param>对应图像太大的那个参数的名称，为image_ref1、image_ref2、image_ref3、image中的一个

请注意：如果图片存储尺寸大于2MB，会触发错误413(Request Entity Too Large)

• "Limit reached." : （这个api_key对当前API的调用量达到上限。仅当api_key为测试key时才有可能发生） 
• "Denied." : （没有权限调用当前API）
• "No data source permission." : （仅为FaceID Verify API存在，表示使用“KYC验证”的方式调用FaceID Verify API，但是没有“KYC验证”的权限）

• 当<param>取值为data_source时，表示参考数据返回的图片无法解析、或者没有照片。注意：这对应Verify 1.0 API里的错误码 400（IDCARD_NO_PHOTO）

• 当KYC验证时，如果参考数据没有指定人的图像、或者图像里没有检测到人脸，参数<param>值为data_source