调用本接口提交用户声纹采样。

描述

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

您必须首先调用开始注册声纹,建立用户信息;然后再调用该接口提交用户的声纹采样,完成用户声纹模型的建立。

在提交同一个用户的声纹采样时,默认您必须依次调用本接口3次(次数可根据业务场景要求调整),提供3个不同的采样。每次声纹采样需要用户念诵指定文本的语音,每次需要念诵的文本包含在上一次调用开始注册声纹或注册声纹接口的返回结果中(即content参数)。第3次成功调用本接口时,返回结果中不包含语音文本。

在调用本接口前,请准备好相应的声纹采样。

请求参数

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

请求body是一个结构体,结构说明如下:
名称 类型 是否必需 描述
session 字符串 调用开始注册声纹时返回的session字段。
content 字符串 语音文本,调用开始注册声纹或上一次调用本接口时返回的content字段。
voice 字符串 用户念诵语音文本生成的声纹采样,使用base64编码。
codec 字符串 语音的编码格式。取值:
  • pcm(默认)
  • amr

返回参数

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

返回body中的Data字段是JSON结构体,结构说明如下:
说明 只有当返回body中code为288或者出错但可重试时,返回body中才有data字段。具体请参考 错误码
名称 类型 是否必需 描述
session 字符串 系统为该次声纹注册生成的唯一标识。
content 字符串 用于注册声纹的语音文本。在提交下一次注册声纹请求时,您必须提供用户念诵该语音文本生成的语音(即声纹采样)。

错误码

只有当您成功提交了一个用户的3次声纹采样后,该用户的声纹注册才会完成,此时系统返回200响应码;用户声纹采样不足3次时,系统返回288,需要您继续提供声纹采样。如果返回其他响应码,则表示注册中遇到错误。

响应码 描述
200 OK,表示该该用户声纹注册已完成。
288 CONTINUE,表示该次注册成功,需要继续调用本接口提供声纹采样。此时在返回参数中有data字段。
其他 表示该次注册失败。您可进一步查看返回参数中是否有data字段,如果有,可重试;否则表示整个用户注册失败,您需要调用开始注册声纹重新注册。

示例

请求示例
{
  "session": "svoice2SUzirHhAVo6PO6sY6mnoG-1oZQqz",
  "content": "39607258", 
  "voice": "UklGRiRtAQBXQVZFZm10IBAAAAABAAEAgD4AAAB9AAACABAAZGF0YQBtAQ..."
}
返回示例
  • 本次注册成功,继续提供声纹采样
    {
    "code":288,
    "msg":"CONTINUE",
    "requestId": "33921869-CF8A-4E62-8C31-44F37341FFC1",
    "data": {
    "content":"36917258",
    "session":"svoice5FyI3MJgXWm4Dwp$Q3YE3H-1oZQ6B"
    }
    }
  • 注册已完成
    {
    "code":200,
    "msg":"OK",
    "requestId": "33921869-CF8A-4E62-8C31-44F37341FFC1"
    }
  • 本次注册失败,但可重试
    {
    "code":400,
    "msg":"the voice is not consistent",
    "requestId": "33921869-CF8A-4E62-8C31-44F37341FFC1",
    "data": {
    "content":"36917258",
    "session":"svoice5FyI3MJgXWm4Dwp$Q3YE3H-1oZQ6B"
    }
    }
  • 本次注册失败且不可重试,只能重新注册
    {
    "code":400,
    "msg":"the voice is not consistent",
    "requestId": "33921869-CF8A-4E62-8C31-44F37341FFC1"
    }