接口描述
注意：
接口请求域名：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 错误码请查看 错误码说明 。
