人脸活体检测
更新时间 2026-06-01 09:32:07
最近更新时间: 2026-06-01 09:32:07
介绍如何调用人脸活体检测能力。
接口描述
用于检测输入图像中的人脸是否为活体。
请求方法
POST
接口要求
图片大小限制:图片单张大小小于2MB。
图片格式限制:图片格式支持jpg/jpeg/png/bmp格式。
URI
/v1/aiop/api/2hfksnibjaos/face-fas-action/person/detectFasFromBase64
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | json格式 | application/json | |
| Authorization | 是 | String | 平台应用APIkey | Bearer $API_KEY | |
| version | 是 | String | 固定值,v4 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| imageContent | 是 | String | 传入图片的base64编码,图片使用常规的base64编码方式,编码后,不包含前缀,剔除前缀例如“data:image/jpeg;base64,” | - |
请求代码示例
Curl -X POST "https://${host}/${api}/v1/aiop/api/2hfksnibjaos/face-fas-action/person/detectFasFromBase64"
-H "Content-Type: application/json"
-H "Authorization: Bearer $API_KEY"
-H "version:v4"
--data '{"imageContent":"AAAAAAAAA...."}'返回值说明
1.请求成功返回响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | String | 返回状态,返回 0 表示成功,返回错误代码参考下面的错误代码列表。 | 0 | |
| message | 是 | String | 如果 code 为 0,返回 success;如果 code 非 0,则返回对应的可读错误信息。 | success | |
| returnObj | 是 | Object | 返回的人脸活体检测结果对象 | returnObj |
2.表returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| face_num | 是 | Int | 图片中人脸的数量 | - | |
| face_list | 是 | List | 每个人脸的详细信息 | - | |
| face_list[].face_location | 是 | Object | 人脸所处位置 | - | |
| face_list[].FaceAntiSpoofing | 是 | String | 活体人脸/非活体人脸/人脸清晰度差,无法判断 | - |
3.请求失败返回响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | String | 错误码,放置API对应的错误码 | 4101 | |
| message | 是 | String | 返回对应的错误信息 | 请求内容错误 | |
| details | 是 | String | 返回对应的错误描述 | 请求内容错误 | |
| error | 是 | String | 返回对应的错误码 | AI_OP_4101 |
返回值示例
1.请求成功返回值示例
{
"statusCode": "0",
"message": "success",
"returnObj":{
"face_num" : 1,
"face_list" : [{
"face_location" : {
"top" : 36,
"left" : 48,
"width" : 58,
"height" : 72
},
"FaceAntiSpoofing" : "活体人脸/非活体人脸/人脸清晰度较差,无法判断",
}]
}
}2.请求失败返回值示例
{
'code': 4101,
'details': '传入内容为空,或者传入的参数名错误',
'error': 'AI_OP_4101',
'message': '请求内容错误',
'statusCode': 4101
}状态码
| http状态码 | 描述 |
|---|---|
| 200 | 表示请求成功 |
错误码说明
4 位错误码,4 开头为业务错误码,5 开头为服务错误码。
| 错误码 | 错误信息 | 错误描述 |
|---|---|---|
| CTAPI_0009 | 无效json的body参数 | |
| AI_OP_4102 | 请求参数格式错误 | 参数格式不满足要求,如请求参数字段类型错误等 |
| AI_OP_4103 | 图片大小超过2M | 图片大小超过2M |
| AI_OP_4104 | 图片解码失败 | 图片为空,base64编码内容有误,或图片格式不支持 |
| AI_OP_4105 | 未检测到人脸 | 上传图片中不包含人脸 |
| AI_OP_5000 | 服务内部错误 | 接口服务出现未知错误 |
base64 编码规则:使用常规的 safe base64 编码方式
python 中推荐使用
base64.urlsafe_b64encode()函数进行编码。java 中推荐使用
BASE64.getUrlEncoder().encodeToString()函数进行编码。