本文提供了调用声纹1:1比对任务的具体内容,旨在帮助您编写程序构建HTTP调用请求。

  • 关于如何构造HTTP请求,请参考请求结构
  • 您也可以直接选用已构造好的HTTP请求,具体请参考SDK参考
声纹1:1比对帮助您判断指定声纹和目标用户声纹是否属于同一个人的声音。在调用声纹1:1比对任务时,您必须:
  1. 先通过开始注册声纹注册声纹接口建立用户信息,并提交目标用户的声纹采样,建立其声纹模型;
    说明 在建立目标用户的声纹模型时,默认您需要成功提交3次(可根据业务场景要求调整)目标声纹的采样。每次声纹采样需要用户念诵指定语音文本的语音,每次需要念诵的语言文本包含在上一次调用开始注册声纹或注册声纹接口的返回结果中(即 content参数)。您总共需要调用1次开始注册声纹和3次(可根据业务场景要求调整)注册声纹,才能完成一个目标用户声纹模型的建立。
  2. 然后通过开始比对声纹比对声纹提供待对比的声纹采样。内容安全输出待对比声纹和目标用户声纹模型的相似度分数,并由此判断它们是否属于同一个人的声音。

描述

业务接口/green/voice/auth/start/register

该接口需要和注册声纹接口一起使用。首先调用该接口建立用户(即目标声纹持有者)信息,该接口返回用于声纹采样的语言文本(即返回参数中的content)。

然后,您需要根据语言文本制作目标用户的声纹采样,并通过注册声纹提交声纹采样,完成声纹模型的建立。

请求参数

关于在请求中必须包含的公共请求参数,请参考公共参数

请求body是一个结构体,结构说明如下:
名称 类型 是否必需 描述
userId 字符串 创建用户ID,用户ID在您的系统里应该是唯一的。
userName 字符串 创建用户名称。

返回参数

返回结果说明,参见返回结果

返回body中的Data字段是JSON结构体,结构说明如下:
名称 类型 是否必需 描述
session 字符串 系统为该次声纹注册生成的唯一标识。
content 字符串 用于注册声纹的语音文本。在提交注册声纹请求时,您必须提供用户念诵该语音文本生成的语音(即声纹采样)。

示例

请求示例
{
  "userId":"userId1",
  "userName":"张三"
}
返回示例
{
  "msg": "OK",
  "code": 200,
  "requestId": "33921869-CF8A-4E62-8C31-44F37341FFC1",
  "data": {
  "content":"39607258",
  "session":"svoice5FyI3MJgXWm4Dwp$Q3YE3H-1oZQ6B"
  }
}