主题
唇语活体
接口描述
通过计算视频中人朗读的数字与系统给出数字串是否相同来判定用户是否为活体.
请求说明
HTTP 方法:
POST请求 URL:
/ai-cloud-face/lipreadingHeader如下:
| 参数名称 | 值 |
|---|---|
| Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
请求参数:
| 参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
|---|---|---|---|---|
| label | 是 | String | 1-8 | label标签 |
| token | 是 | String | 1-32 | Token信息 |
| video | 是 | String | 1-20M | 视频的base64编码 |
| type | 是 | String | 1-32 | 视频的类型,如mp4 |
| busFlowId | 否 | String | 1-64 | 业务流水号,业务系统唯一序列号(对账用,建议传入) |
请求示例:
{
"token": "2725713764420326",
"label": "8326",
"type":"mp4",
"video":"AAAAGGZ0eXBtcDQyAAAAAGlzb21tcDQyAAAHFW1vb3YAAABsbXZoZAAAAADjRKK/40SivwAAJx..."
}返回说明
返回参数:
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| code | int | 1-8 | 返回结果,0表示成功 |
| message | String | 1-255 | 返回码描述 |
| data | Object | - | 返回的数据 |
| -code | int | 4 | 唇语检测出现错误时,返回具体错误码 |
| -errorInfo | String | 1-511 | 错误信息 |
| -faceImage | String | 1-200k | result 为0的情况下,返回最佳人脸 jpg格式 |
| -busFlowId | String | 1-64 | 业务流水号,业务系统唯一序列号 |
| -flowId | String | 1-64 | 交易流水ID(建议保存) |
返回示例:
{
"code": 0,
"message": "success",
"success": true,
"data": {
"code": 0,
"errorInfo": "success",
"faceImage": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
}
}错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共CODE码表
| 码值 | 是否成功 | 是否计费 | 描述 |
|---|---|---|---|
| 00000000 | 是 | 是 | 成功 |
| 50029112 | 否 | 否 | 引擎检测异常 |
| 50029113 | 否 | 否 | 引擎检测异常 |
| 50029802 | 否 | 否 | 视频不能为空 |
| 50029803 | 否 | 否 | 视频大小不能超过20M |
| 50029805 | 否 | 否 | 唇语标签不能为空 |
| 50029806 | 否 | 否 | 唇语标签长度不能超过8位 |
| 50029807 | 否 | 否 | 唇语token不能为空 |
| 50029808 | 否 | 否 | 唇语token长度不能超过32位 |
| 50029336 | 否 | 否 | 唇语活体检测异常 |