声纹辨认 - 开放平台WebAPI V4.3.0

本接口主要提供声纹辨认1：N接口，可上传多条语音文件合并后提取为一个声纹特征进行辨识。

辨认时将声纹特征与指定声纹库（支持多声纹库）进行比对，并返回TOP N的比对结果。

说明：
1、如何确定声纹检索是否命中？
在返回的比对结果中，有score和isMatched种判定方式，可通过score与自己设定的阈值比对或者isMatched（本平台阈值判定后的结果）来判断检索是否命中。

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

x-vai-token

string

业务Token

必需

Body 参数application/json

channel

string

必需

渠道编号，1-20个英文或数字

files

array [object {2}]

必需

文件ID集（最多支持10个,大小总和小于20M）

fileId

string

文件标识

必需

text

string

可选

进行语音识别的文本内容，和语音内容一致才能通过检测。

groupId

array[string]

必需

目标声纹库ID(支持选择多个）(上限10个）

topN

string

可选

希望返回的特征结果数量，最多20,默认20

needCheckInfo

boolean

可选

示例

{
    "channel": "string",
    "files": [
        {
            "fileId": "string",
            "text": "string"
        }
    ],
    "groupId": [
        "string"
    ],
    "topN": "string",
    "needCheckInfo": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

状态，0 成功 1部分成功 300306 目标声纹库无声纹 300117 无有效音频 -9999 系统异常 -9998 算法服务异常

msg

string

错误消息哈哈

必需

rid

string

必需

本次会话唯一标识ID

data

object | null

返回数据

可选

result

array [object {6}]

可选

topN结果列表，按照分数从高到低排列

checkInfo

array [object {5}]

音频检测信息集

可选

示例

{
    "code": 0,
    "msg": "string",
    "rid": "string",
    "data": {
        "result": [
            {
                "isMatched": "string",
                "score": "string",
                "vpId": "string",
                "vpName": "string",
                "vplibId": "string",
                "vplibName": "string"
            }
        ],
        "checkInfo": [
            {
                "fileId": "string",
                "vadCheck": 0,
                "asvCheck": 0,
                "textMatch": 0,
                "isValid": 0
            }
        ]
    }
}