声纹确认（文件比特征） - 开放平台WebAPI V4.3.0

本接口主要提供声纹验证1：1接口，该接口可以将上传的多条语音合并后做提取声纹特征与声纹库中的某一个特征进行1:1比对验证，并返回相似度分值。
验证接口中，说话人A来验证说话人B是不是同一个人。说话人A的语音和声纹特征，称为验证语音和验证声纹特征。说话人B的语音和声纹特征，称为被验证语音和被验证声纹特征。

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

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

音频要求：
1、支持文件格式: .wav、.m4a、.aac、.mp3、.opus、.flac、.amr、.ogg、.wma、.silk、.mp4、.wmv、.avi，8k/16k采样率，单/双声道；
2、多条验证音频，总大小最大不超过20MB。

请求参数

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

string

目标声纹库ID

必需

tagId

string

1比1目标声纹ID

必需

needCheckInfo

boolean

可选

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

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

msg

string

错误消息

必需

rid

string

必需

本次会话唯一标识ID

data

object

返回数据

可选

result

object

可选

checkInfo

array [object {5}]

音频检测信息集

可选

示例

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