登录

文档中心

文档目录

活体检测(动态)

最近更新时间: 2024-04-23 10:05:31

1. 接口说明(活体检测动态)

1.1 发起请求

1.1.1 接口协议

HTTP  POST

1.1.2 接口协议

https://api.juncyun.com/api/safFace/dynamicFaceCheck

1.1.3 报头定义

编码

列表

内容

备注

1) 

Accept

multipart/form-data

 

2) 

Content-Type

multipart/form-data;charset=utf-8

 

 

1.1.4 请求参数

1.1.4.1. 请求参数列表

编码

列表

内容

备注

1) 

accessKey

API调用账号(必填,从云极平台获取)

 

2) 

accessSecret

API调用密钥(必填,从云极平台获取)

 

3) 

url

视频文件地址,下载限时10秒,file和url二选一( 可选)

 

4) 

file

视频文件,适合本地文件上传,file和url二选一( 可选)

 

5) 

motions

用户动作序列:BLINK - 眨眼;MOUTH - 张嘴; NOD - 点头;YAW - 摇头

 

 

1.1.4.2. 请求参数示例

使用form-data格式传输。

1.1.5 响应参数

1.1.5.1. 响应参数列表

编码

列表

内容

备注

1) 

code

状态码200则为成功

 

2) 

msg

状态说明 

 

3) 

success

处理是否成功:取值范围 true,false

 

4) 

data

业务数据 如果失败则为空

 

5) 

+reqNo

请求序列号

 

6) 

+passed

总体检测结果,true - 通过,false - 未通过

 

7) 

++desc

passed为false 活体检查失败的原因

 

8) 

+requestId

流水号

 

9) 

+fee

是否扣费  0不收费1收费

 

10) 

++face_image_url

活体成功之后,抓取的人脸照片

 

11) 

++hack_score

防hack检测分数,hack_score阈值为0.98,由行业大数据训练得到,大于0.98是hack行为,小于等于0.98是正常活人

 

12) 

++motions

用户动作序列

 

13) 

+++motion

用户动作序列

 

14) 

+++score

单个动作分值 > 0.2表示通过,<= 0.2表示不通过

 

15) 

+++passed

单个动作检测结果

 

 

1.1.5.2. 响应成功参数示例

{

"code": 200,

"msg": "核查通过",

"success": true,

"data": {

"face_image_url":"https://img2.jumdata.com/a.jpg",

"hack_score": 0.4493361287443779,

"requestId": "4529249871948222",

"fee": 1,

"motions": {

"score": 0.48755034492623084,

"motion": "BLINK",

"passed": true

},

"reqNo": "AI1705919990xx",

"passed": true,

"desc": "检测通过"

}

}

 

1.1.5.3. 结果码说明

结果码

描述

200

成功

500,501,503

系统错误

502

系统繁忙

60021

余额不足,请充值后重试!

10000

内部系统出错,请联系厂商

活体检测(动态)

最近更新时间: 2024-04-23 10:05:31

1. 接口说明(活体检测动态)

1.1 发起请求

1.1.1 接口协议

HTTP  POST

1.1.2 接口协议

https://api.juncyun.com/api/safFace/dynamicFaceCheck

1.1.3 报头定义

编码

列表

内容

备注

1) 

Accept

multipart/form-data

 

2) 

Content-Type

multipart/form-data;charset=utf-8

 

 

1.1.4 请求参数

1.1.4.1. 请求参数列表

编码

列表

内容

备注

1) 

accessKey

API调用账号(必填,从云极平台获取)

 

2) 

accessSecret

API调用密钥(必填,从云极平台获取)

 

3) 

url

视频文件地址,下载限时10秒,file和url二选一( 可选)

 

4) 

file

视频文件,适合本地文件上传,file和url二选一( 可选)

 

5) 

motions

用户动作序列:BLINK - 眨眼;MOUTH - 张嘴; NOD - 点头;YAW - 摇头

 

 

1.1.4.2. 请求参数示例

使用form-data格式传输。

1.1.5 响应参数

1.1.5.1. 响应参数列表

编码

列表

内容

备注

1) 

code

状态码200则为成功

 

2) 

msg

状态说明 

 

3) 

success

处理是否成功:取值范围 true,false

 

4) 

data

业务数据 如果失败则为空

 

5) 

+reqNo

请求序列号

 

6) 

+passed

总体检测结果,true - 通过,false - 未通过

 

7) 

++desc

passed为false 活体检查失败的原因

 

8) 

+requestId

流水号

 

9) 

+fee

是否扣费  0不收费1收费

 

10) 

++face_image_url

活体成功之后,抓取的人脸照片

 

11) 

++hack_score

防hack检测分数,hack_score阈值为0.98,由行业大数据训练得到,大于0.98是hack行为,小于等于0.98是正常活人

 

12) 

++motions

用户动作序列

 

13) 

+++motion

用户动作序列

 

14) 

+++score

单个动作分值 > 0.2表示通过,<= 0.2表示不通过

 

15) 

+++passed

单个动作检测结果

 

 

1.1.5.2. 响应成功参数示例

{

"code": 200,

"msg": "核查通过",

"success": true,

"data": {

"face_image_url":"https://img2.jumdata.com/a.jpg",

"hack_score": 0.4493361287443779,

"requestId": "4529249871948222",

"fee": 1,

"motions": {

"score": 0.48755034492623084,

"motion": "BLINK",

"passed": true

},

"reqNo": "AI1705919990xx",

"passed": true,

"desc": "检测通过"

}

}

 

1.1.5.3. 结果码说明

结果码

描述

200

成功

500,501,503

系统错误

502

系统繁忙

60021

余额不足,请充值后重试!

10000

内部系统出错,请联系厂商

加微咨询

一对一服务,更有优惠惊喜