本文提供了调用图片同步检测任务进行活体翻拍检测的具体接口和参数说明,旨在帮助您编写程序构建HTTP调用请求。

  • 关于如何构造HTTP请求,请参见请求结构
  • 您也可以直接选用已构造好的HTTP请求,具体请参见SDK参考

描述

业务接口/green/image/scan

提交图片同步检测任务,进行活体翻拍检测,检测图片中的活体对象(主要是人脸)来自直接拍摄或翻拍。

活体判断的前置条件是图像中有人脸。建议将该功能与敏感人脸检测功能组合使用。先调用敏感人脸识别接口进行检测,检测到人脸后,调用活体翻拍检测接口判断是否为翻拍。
说明 该接口为计费接口,具体请参见计费说明。

关于检测时长

同步检测允许的最长检测时间是6秒,如果检测在该时间限制内没有完成,系统会强制返回超时错误码。如果您对实时性要求不高,可以选择异步检测;其它情况下,请选择同步检测,同步检测接口的调用相对简单些。对于同步检测接口的调用,建议您将超时时间设置为6秒。

关于图片的限制
  • 图片链接支持以下协议:HTTP和HTTPS。
  • 图片支持以下格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
  • 图片大小限制为10MB以内(适用于同步和异步调用)。如您有特殊需求(大图片),可以提工单进行调整。
  • 图片下载时间限制为3s内,如果下载时间超过3s,返回下载超时。
  • 图片像素建议不低于256*256,像素过低可能会影响识别效果。
  • 图片检测接口响应时间依赖图片的下载时间。请保证被检测图片所在的存储服务稳定可靠,建议您使用阿里云OSS存储或者CDN缓存等。

请求参数

关于在请求中必须包含的公共请求参数,请参见公共参数

请求body是一个JSON对象,字段说明如下。
名称 类型 是否必需 描述
bizType 字符串 该字段用于标识业务场景。针对不同的业务场景,您可以配置不同的内容审核策略,以满足不同场景下不同的审核标准或算法策略的需求。您可以通过云盾内容安全控制台创建业务场景(bizType),或者通过工单联系我们帮助您创建业务场景。
scenes 字符串数组 指定图片检测的应用场景,取值:liveness
tasks JSON数组 指定检测对象,JSON数组中的每个元素是一个图片检测任务结构体(image表)。最多支持10个元素,即对10张图片进行检测。每个元素的具体结构描述见task
表 1. task
名称 类型 是否必需 描述
dataId 字符串 数据Id。需要保证在一次请求中所有的Id不重复。
url 字符串 待检测图像的URL。

返回参数

返回结果说明,参见返回结果

返回body中的data字段是JSON数组,每一个元素包含如下字段。
名称 类型 是否必需 描述
code 整型 错误码,和HTTP的status code一致。
msg 字符串 错误描述信息。
dataId 字符串 对应请求中的dataId
taskId 字符串 该检测任务的ID。
url 字符串 对应请求中的URL。
extras Map 附加信息。该值可能会调整,建议您不要在业务上进行依赖。
results 数组 返回结果。调用成功时(code=200),返回结果中包含一个或多个元素。每个元素是个结构体,具体结构描述见result
表 2. result
名称 类型 是否必需 描述
scene 字符串 风险场景,取值:liveness
label 字符串 检测结果的分类,取值:
  • normal:活体照片
  • liveness:翻拍照片
suggestion 字符串 建议用户执行的操作,取值范围:
  • pass:图片中的活体对象来自直接拍摄,无需进行其余操作
  • review:图片中的活体对象可能来自翻拍,建议您确认后再进行操作
  • block:图片中的活体对象大概率来自翻拍,建议您执行后续操作
rate 浮点数 结果为该分类的概率,取值范围为[0.00-100.00]。值越高,表示越有可能属于该分类。
livenessData 结构体 活体检测结果判断为翻拍(label=liveness)时,返回的活体检测信息。具体结构描述见livenessData
表 3. livenessData
名称 类型 是否必需 描述
rate 浮点数 活体照片属于翻拍的概率。分值越高,表示属于翻拍的概率越大。

示例

请求示例
{
  "scenes": ["liveness"],
  "tasks": [
    {
      "dataId": "test2NInmO$tAON6qYUrtCRgLo-1mwxdi",
      "url": "https://img.alicdn.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png"
    }
  ]
}
返回示例
{
  "code":200,
  "msg":"OK",
  "requestId":"9EEF894F-A933-4830-97B1-EC1A9630A9D6"
  "data":[
    {
      "code":200,
      "dataId":"test2NInmO$tAON6qYUrtCRgLo-1mwxdi",
      "taskId":"img2hsbmQeA4CU7l78$s8q5mW-1pnn7Z",
      "url":"https://img.alicdn.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png"
      "extras":{}
      "msg":"OK",
      "results"
        {
          "label"liveness",
          "rate":97.0,
          "scene:"liveness",
          "suggestion":"review"
                  "livenessData":{
                                      "rate":97.0
                                 }
        }
      ]
    }
  ]
}