统一应用 API Key 模式
更新时间：2026-09-11 17:04:56
一、静态活体检测
协议说明
本接口用于对单张图片进行静态活体检测，判断图片中是否为真实的人脸。
| 名称 | 说明 |
|---|---|
| 协议 | 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 }
这篇文档对您有帮助吗？
