/face/anti_hack_ir

1.接口描述

该API用于双目活体检测，检测是否存在hack行为

  • 图片要求
    1. 格式为 JPG（JPEG），BMP，PNG，GIF，TIFF
    2. 宽和高大于 128px，小于等于4000px (人脸不小于50*50px)
    3. 小于等于 5 MB

请求方式：

POST

请求URL：

http://cloudapi.deepfinch.com/face/anti_hack_ir

调试工具

Debugging Tool

2.请求参数

2.1 请求头域

字段 类型 必需 描述
X-DF-API-ID string 是 API调用凭证信息，详细信息请参考API调用
X-DF-API-SECRET string 是 API调用凭证信息，详细信息请参考API调用

2.2 请求体

字段 类型 必需 描述
file file 见下方注释 RGB图片的file，本地上传选取此参数
url string 见下方注释 RGB图片的url，从网络获取时选取此参数
image_base64 string 见下方注释 RGB图片的base64编码
ir_file file 见下方注释 红外图片的file，本地上传选取此参数
ir_url string 见下方注释 红外图片的url，从网络获取时选取此参数
ir_image_base64 string 见下方注释 红外图片的base64编码
x_offset int 见下方注释 将RGB图片上的人脸检测框映射到红外图片上时，在X轴上需要做的相对偏移，默认值为0
y_offset int 见下方注释 将RGB图片上的人脸检测框映射到红外图片上时，在Y轴上需要做的相对偏移，默认值为0

RGB图片和红外图片的人脸方向和长宽比例需要保持一致，以帮助防hack引擎对两张图片上的人脸进行准确对齐。

偏移参数 x_offset和y_offset 用于两张图片上人脸的对齐，其取值与设备上双目摄像头之间的物理距离及上传图片分辨率有关；请根据实际使用场景进行调整，不建议保持默认值0。

请求参数 file、url、image_base64 三选一。

请求参数 ir_file、ir_url、ir_image_base64 三选一。

参数 file 和 ir_file 需把图片文件以 multipart/form-data 的形式放到 POST 消息体中。

3.返回参数

正常响应 （200）

字段 类型 描述
request_id string 本次请求的 id
status string 状态。正常为 OK ，其他值表示失败。详见错误码
score float hack检测分数。取值范围是0~1。值越大，表示被hack的可能性越大

备注：hack score阈值为0.98，由行业大数据训练得到，大于0.98是hack行为，小于等于0.98是正常活人**

输出示例：

{
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e",
  "status": "OK",
  "score": 0.999316
}

4.错误码

状态码 status 字段 说明
400 INVALID_ARGUMENT 请求参数错误
400 DETETION_FAILED 图片检测失败
400 DOWNLOAD_ERROR 网络地址图片获取失败
401 UNAUTHORIZED 未授权或授权失败
401 KEY_EXPIRED 账号过期
403 NO_PERMISSION 无调用权限
403 OUT_OF_QUOTA 调用次数超出限额
403 RATE_LIMIT_EXCEEDED 调用频率超出限额
404 NOT_FOUND 请求路径错误
500 INTERNAL_ERROR 服务器内部错误

输出示例：

{
  "status": "DETETION_FAILED",
  "reason": "no face detected",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.输入示例

results matching ""

    No results matching ""