向系统添加新的声纹信息，自动提取音频特征生成声纹向量，用于后续的声纹识别和验证。

• 音频数据必须为 PCM 格式，采样率 16kHz，位深 16bit，单声道。
• PCM 数据需要进行 Base64 编码后传输。
• 声纹名称在同一用户下需要唯一。
• 建议音频时长在 3-10 秒之间以获得最佳识别效果。

请求信息

请求 URI

POST https://rtc-agent.yunxinapi.com/v1/voice_prints

请求头参数

请求 Header 的参数说明请参考 请求结构。

请求体参数

参数名称	类型	是否必选	示例	说明
userId	String	是	user01	用户唯一标识，长度不超过 64 个字符
name	String	是	jack	声纹名称，同一用户下需要唯一，长度不超过 32 个字符
pcmData	String	是	xxxxxx==	音频 PCM 格式数据的 Base64 编码，建议音频时长 3-10 秒
subAccountUid	String	是	sub_user_01	子用户 ID，在操作子用户时候必填。最大长度 32 字节，只允许字母、数字以及 "_@.-"

请求体示例

JSON{
  "userId": "user01",
  "name": "jack",
  "subAccountUid": "sub_user_01",
  "pcmData": "xxxxxx=="
}

响应信息

响应参数

参数名称	类型	说明	是否必返回
code	Integer	状态码，200 表示请求成功	是
message	String	提示信息，请求失败时返回错误信息，请求成功时返回"success"	是
- data	Object	返回的 JSON 数据对象，请求失败则返回空对象	是
userId	String	用户唯一标识	是
name	String	声纹名称	是
embedding	Array	声纹特征向量数组	是
voicePrintId	String	声纹唯一标识 ID	是

响应体示例

JSON{
  "code": 200,
  "message": "success",
  "data": {
    "userId": "user01",
    "name": "jack",
    "embedding": [0.0067223333333, -0.23333344433],
    "voicePrintId": "99IOEqmdsa"
  }
}