有奖捉虫:云通信与企业服务文档专题,速来> HOT

接口描述

注意:

  • 人脸识别全面升级接口,算法更强、性能更优,欢迎立即体验 人脸识别
  • 新老版本的接口不兼容,控制台的数据统计不互通,但计费模式相同,且共享计费阶梯。
  • 人脸识别1.0版本接口已从2019年6月21日起停止维护,如果您使用的仍是当前的旧接口,请尽快升级成 2.0版本

接口请求域名:https://recognition.image.myqcloud.com/face/livedetectpicture
本接口(livedetectpicture)用于对用户上传的静态照片进行人脸活体检测。与动态活体检测的区别是:静态活体检测中,用户不需要通过唇语或摇头眨眼等动作来识别。
静态活体检测仅用于对防攻击要求不高的场景,如果对活体检测有更高安全性要求,请使用 活体人脸比对

注意:

  • 本接口支持 HTTPS 协议,如果您现在使用的是 HTTP 协议,为了保障您的数据安全,请切换至 HTTPS。
  • 如果开发者使用的是原域名(service.image.myqcloud.com),为获得更好的体验,请及时切换到以上域名。

请求头 header

所有请求都要求含有下表列出的头部信息:

参数名 必选 描述
host recognition.image.myqcloud.com 腾讯云人脸识别服务器域名。
content-length 包体总长度 图片大小建议小于1280 * 720px;每个请求的包体大小限制为6MB;不支持 .gif 类型的动图。
content-type application/json 或 multipart/form-data 据不同接口选择:
1. 使用 application/json 格式,参数为 url,其值为图片的 url。
2. 使用 multipart/form-data 格式,参数为 image,其值为图片的二进制内容。
authorization 鉴权签名 多次有效签名,用于鉴权,生成方式见 鉴权签名方法
注意:

如选择 multipart/form-data,请使用 HTTP 框架/库推荐的方式设置请求的 content-type,不推荐直接调用 setheader 等方法设置,否则可能导致 boundary 缺失引起请求失败。

输入参数

使用 application/json 格式,参数选择 url;使用 multipart/form-data 格式,参数选择 image。

参数名 必选 类型 说明
appid String 接入项目的唯一标识,可在 账号信息云 API 密钥 中查看
image Binary 图片内容(图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义)
url String 图片的 image 和 url 只提供一个即可,如果都提供,只使用 url(图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义)
注意:

图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义。

输出参数

字段 类型 说明
data.score Int 活体打分,取值范围 [0,100],分数一般落于[80, 100]区间内,0分也为常见值。推荐值大于 87 时可判断为活体。可根据具体场景自行调整阈值。
code Int 错误码。
message String 错误描述。

示例

输入示例

使用 url

POST /face/livedetectpicture HTTP/1.1
Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==
Host: recognition.image.myqcloud.com 
Content-Length: 117
Content-Type: "application/json"

{"appid":"1000001","url":"http://test-123456.image.myqcloud.com/test.jpg"}

使用 image

POST /face/livedetectpicture HTTP/1.1
Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==
Host: recognition.image.myqcloud.com 
Content-Length: 641
Content-Type: multipart/form-data;boundary=--------------acebdf13572468

----------------acebdf13572468
Content-Disposition: form-data; name="appid";

123456----------------acebdf13572468
Content-Disposition: form-data; name="image"; filename="face.jpg"
Content-Type: image/jpeg

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
----------------acebdf13572468--

输出示例

HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 168
Content-Type: application/json
{
"data":{
"score":30,
},
"code":0,
"message":"OK"
}

错误码

错误码 含义
3 错误的请求;其中 message:account abnormal,errorno is:2 为账号欠费停服
4 签名为空
5 签名串错误
6 签名中的 APPID/Bucket 与操作目标不匹配
9 签名过期
10 APPID 不存在
11 SecretId 不存在
12 APPID 和 SecretId 不匹配
13 重放攻击
14 签名校验失败
15 操作太频繁,触发频控
16 Bucket 不存在
21 无效参数
23 请求包体过大
24 本接口即将下线,请使用 新版人脸识别
107 鉴权服务不可用
108 鉴权服务不可用
213 内部错误
-4006 视频中自拍照特征提取失败
-4007 视频中自拍照之间对比失败
-4009 Card 照片提取特征失败
-4010 自拍照与Card照片相似度计算失败
-4015 自拍照人脸检测失败
-4016 自拍照解码失败
-4017 Card 照片人脸检测失败
-4018 Card 照片解码失败
-5001 视频无效
-5002 唇语失败
-5005 自拍照解析照片不足
-5007 视频没有声音
-5008 声音识别失败
-5009 视频人脸检测失败,没有嘴或者脸
-5010 唇动失败
-5011 活体检测失败(活体其他错误都归类到里面)
-5012 视频中噪声太大
-5013 视频里的声音太小
-5014 活体检测 level 参数无效
-5015 视频像素太低,最小320 * 480
-5801 请求缺少身份证号码或身份证姓名
-5802 服务器内部错误,服务暂时不可用
-5803 身份证姓名与身份证号码不一致
-5804 身份证号码无效
-5805 用户未输入图像或者 url 下载失败
-5806 身份证号码或者身份证姓名格式错误
-5807 查询身份证信息错误

更多其他 API 错误码请查看 错误码说明