接口问题（新）
更新时间：2026-07-31 19:58:39
一、静态活体检测
协议说明
本接口用于对单张图片进行静态活体检测，判断图片中是否为真实的人脸。
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| Content-Type | application/json |
| URL | https://wsapi.253.com/api/v2/sdk/witness/face-check |
请求头参数
请求头参数以及生成规则，可参考文档中的通用请求头：通用请求头
请求参数说明
请求参数 Body 以 application/json（JSON Body）方式提交
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| image | string | 是 | 图片Base64编码，支持JPG/PNG/BMP格式，大小不超过2M |
请求示例
{
"image": "https://example.com/document.jpg"
}请求结果说明
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| code | String | 返回状态码，仅使用 OM 标准 code 码，详细列表请参考：统一错误码 |
| msg | String | 响应code码解释 |
| requestId | String | 订单号 |
| chargeStatus | int | 计费条数 |
| chargeCount | int | 是否收费,1：收费 0：不收费 |
| data | Object | 返回对象 |
| faceId | String | 人脸ID |
| isLived | string | 是否活体，0：非活体，1：活体 |
| score | float | 活体分数，范围0-100 |
| msg | string | 结果描述 |
请求成功-结果示例
{
"msg": "success",
"chargeCount": 1,
"code": "000000",
"data": {
"faceId": "",
"isLived": "1",
"score": 98.5,
"msg": "活体"
},
"requestId": "YQis1222128184616292352",
"chargeStatus": 1
}请求失败-结果示例
{
"msg": "系统错误",
"chargeCount": 0,
"code": "301000",
"requestId": "PhcE1222590326496894976",
"chargeStatus": 0
}二、动态活体检测
协议说明
本接口用于通过视频或图片序列进行动态活体检测，通过动作配合判断是否为真实的人脸。
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| Content-Type | application/json |
| URL | https://wsapi.253.com/api/v2/sdk/htjc/lifecheck |
请求头参数
请求头参数以及生成规则，可参考文档中的通用请求头：通用请求头
请求参数说明
请求参数 Body 以 application/json（JSON Body）方式提交
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| motions | String | 是 | 用户动作序列：BLINK - 眨眼；MOUTH - 张嘴； NOD - 点头；YAW - 摇头 |
| file | String | 否 | 视频文件，适合本地文件上传，file和url二选一 |
| url | String | 否 | 视频文件地址，下载限时10秒，file和url二选一 |
请求示例
{
"motions": "BLINK,MOUTH,NOD",
"url": "https://example.com/video.mp4"
}请求结果说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费，枚举值：1 ：收费 0：不收费 |
| code | String | 响应code码。 200000：成功 500000: 失败 |
| msg | String | 响应code码解释 |
| requestId | String | 订单号 |
| data | Object | 返回对象 |
| result | Object | 结果 |
| face_image_url | String | 活体成功之后，抓取的人脸照片（链接有效期一天） |
| hack_score | int | 防hack检测分数，hack_score阈值为0.98，由行业大数据训练得到，大于0.98是hack行为，小于等于0.98是正常活人 |
| motions | Object | 用户动作序列 |
| score | int | 单个动作分值 > 0.2表示通过，<= 0.2表示不通过 |
| motion | String | 用户动作序列 |
| passed | Boolean | 单个动作检测结果 |
| passed | Boolean | 总体检测结果，true - 通过，false - 未通过 |
| desc | String | passed为false 活体检查失败的原因 |
| request_id | String | 流水号 |
请求成功-结果示例
{
"msg": "success",
"chargeCount": 1,
"code": "000000",
"data": {
"result": {
"face_image_url": "https://img2.jumdata.com/lifecheck-face/20260630/86/3fdfbb5acbd9403d9ee247bb385fbcc0.jpg",
"hack_score": 0.2769989266716422,
"motions": {
"score": 0.3465524733126413,
"motion": "BLINK",
"passed": true
},
"passed": true,
"desc": "检测通过"
},
"request_id": "Dkos1224047181397446656"
},
"requestId": "Dkos1224047181397446656",
"chargeStatus": 1
}这篇文档对您有帮助吗？
