开放平台WebAPI V4.3.0
  1. 声纹比对
开放平台WebAPI V4.3.0
  • 接口概览
  • 错误码
  • TOKEN
    • AK/SK获取TOKEN
      POST
    • 刷新TOKEN
      POST
  • 文件服务
    • 上传音频文件
      POST
    • 下载音频文件
      POST
  • 声纹库管理
    • 新建声纹库
      POST
    • 修改声纹库
      POST
    • 删除声纹库
      POST
    • 查看声纹库列表
      POST
  • 特征管理
    • 查询声纹是否存在
      POST
    • 注册声纹
      POST
    • 更新声纹
      POST
    • 删除声纹
      POST
    • 移动声纹
      POST
    • 获取声纹列表
      POST
  • 声纹比对
    • 声纹确认(文件比特征)
      POST
    • 声纹确认(文件比文件)
      POST
    • 声纹辨认
      POST
    • 声纹聚类
      POST
    • 声纹聚类结果查询
      POST
    • 获取提示文本
      POST
    • 检测提示文本
      POST
  • 语音拓展
    • 年龄识别
      POST
    • 人声分割
      POST
  • 语音识别
    • 录音文件转写
    • 查询转写结果
  1. 声纹比对

声纹确认(文件比文件)

POST
/openai/v1/file/verify
V4.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 参数multipart/form-data
fileId
string 
比对文件Id
可选
byFileId
string 
被比对文件Id
可选
needCheckInfo
boolean 
可选
是否需要返回音频检查信息(质检)

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/openai/v1/file/verify' \
--header 'x-vai-token;' \
--form 'fileId=""' \
--form 'byFileId=""' \
--form 'needCheckInfo=""'

返回响应

🟢200成功
application/json
Body
code
integer 
状态,0表示成功,
必需
msg
string 
错误消息
必需
rid
string 
必需
本次会话唯一标识ID
data
object 
返回数据
必需
result
object 
比对结果
必需
checkInfo
array [object {5}] 
音频检测信息集
必需
示例
{
    "code": 0,
    "msg": "string",
    "rid": "string",
    "data": {
        "result": {
            "score": "string",
            "isMatched": "string"
        },
        "checkInfo": [
            {
                "fileId": "string",
                "vadCheck": 0,
                "asvCheck": 0,
                "textMatch": 0.5,
                "isValid": "string"
            }
        ]
    }
}
上一页
声纹确认(文件比特征)
下一页
声纹辨认
Built with