视频活体检测APIAPI接口_免费数据接口-开发屋

视频活体检测API

接口地址

https://tianyan.apistd.com/v2/life/check

请求格式

multipart/form-data

响应格式

application/json

请求方法

POST

请求参数 (Query)

参数名	类型	必须	描述
key`string`	`string`	是	请求 AccessKey, 请在控制台中查看

请求参数 (Body)

参数名	类型	必须	描述
file`file`	`file`	否	视频文件，适合本地文件上传，file和url二选一
url`string`	`string`	否	视频文件网络地址，下载限时10秒，file和url二选一
motions`string`	`string`	是	用户动作序列，BLINK 眨眼；MOUTH 张嘴； NOD 点头；YAW 摇头
complexity`integer`	`integer`	否	活体检测通过的难易程度，默认为0， 0：简单模式；1：正常模式；2：困难模式；3：地狱模式

返回参数 (Body)

参数名	类型	描述
success`boolean`	`boolean`	接口请求成功标识，true为成功，false为失败，失败情况下，会有对应描述和状态码
code`number`	`number`	成功为200，其它为失败状态码
msg`string`	`string`	code对应的说明描述
data`object`	`object`	验证结果详细信息
└ order_no`string`	`string`	订单号
└ motions`object`	`object`	单个行为检测结果
└ passed`boolean`	`boolean`	总体检测结果
└ feature_image_id`string`	`string`	行为特征照片id,可以根据该id调获取行为特征照片接口获取图片
└ hack_score`number`	`number`	防hack检测分数，hack_score阈值为0.98，由行业大数据训练得到，大于0.98是hack行为，小于等于0.98是正常活人

请求返回示例

{
  "msg": "",
  "success": true,
  "code": 200,
  "data": {
    "order_no": "588410148050046976",
    "motions": {
      "score": 0.9999746084213257,
      "motion": "BLINK",
      "passed": true
    },
    "passed": true,
    "feature_image_id": "efdc743eda7744ce9be4080654deb4c1",
    "hack_score": 0.7475364208221436
  }
}

检查用户拍摄的视频是否为活体

视频要求：大小建议不超过5M（视频时长2秒左右），常用视频格式都支持

用户见解

你也使用过这个API吗？欢迎分享你的见解

与大家分享你的见解、观点、比较或使用心得

错误码	描述
200	成功，计费
400	参数错误
404	请求资源不存在
500	系统内部错误，请联系服务商
501	第三方服务异常
601	服务商未开通接口权限
602	账号停用
603	余额不足请充值
604	接口停用
1001	其他，以实际返回为准

const https = require('https');

const options = {
  'method': 'POST',
  'hostname': 'tianyan.apistd.com',
  'path': '/v2/life/check?key=your_access_key_here',
  'headers': {
    'Content-Type': 'multipart/form-data'
  }
};

const req = https.request(options, (res) => {
  const chunks = [];

  res.on("data", (chunk) => {
    chunks.push(chunk);
  });

  res.on("end", (chunk) => {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", (error) => {
    console.error(error);
  });
});

const postData = "------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"url\"\r\n\r\nPathtovideoFile\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"motions\"\r\n\r\nBLINK\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW\r\nContent-Disposition: form-data; name=\"complexity\"\r\n\r\n0\r\n------WebKitFormBoundary7MA4YWxkTrZu0gW--";

req.setHeader('content-type', 'multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW');

req.write(postData);

req.end();

* 以上示例代码仅供参考，建议根据您的实际业务场景及技术架构发起 HTTP API 请求