开放平台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/tag/cluster
V4.0
本接口主要提供声纹聚类功能,可对一批声纹特征进行聚类,支持选择整个声纹库或部分声纹进行聚类。
如果填写了回调地址,聚类任务完成后,我们会调用回调地址通知,支持get 请求,我们会在回调地址中拼接参数,长度限制512,例如:
http://{ip}/{port}?xxx&taskId=xxxx&status=1
参数:taskId为任务编号、status为任务状态: 1(聚类成功) 、-1(聚类失败)

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/json
x-vai-token
string 
业务Token
必需
Body 参数application/json
channel
string 
必需
渠道编号,1-20个英文或数字
group
array [object {1}] 
必需
聚类目标声纹,最多支持10个声纹库
groupId
string 
必需
参与聚类的声纹库标识
示例
{
    "channel": "string",
    "group": [
        {
            "groupId": "string"
        }
    ]
}

示例代码

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/tag/cluster' \
--header 'x-vai-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "channel": "string",
    "group": [
        {
            "groupId": "string"
        }
    ]
}'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
错误码,0成功 300306 目标声纹库无声纹 300110 目标分组不存在 300011 同人检测不通过 300306目标声纹库无声纹 -9999 系统异常 -9998 算法服务异常
msg
string 
错误消息哈哈
必需
rid
string 
必需
本次会话唯一标识ID
data
object 
必需
taskId
string 
聚类任务Id
必需
示例
{
    "rid": "20",
    "code": 40,
    "msg": "aliqua id dolore",
    "taskId": "40"
}
上一页
声纹辨认
下一页
声纹聚类结果查询
Built with