实时音视频
实时音视频
文档指南
请输入
- 文档首页
实时音视频AI 音视频互动方案API 参考声纹管理更新声纹 UpdateVoicePrint
复制全文
下载 pdf更新声纹 UpdateVoicePrint
文档反馈
问问助手为已存在的声纹 ID (VoicePrintId) 上传一段新的音频以更新声纹。也可单独用于更新指定声纹的名称 (AudioName) 和元信息 (AudioMetaInfo)。
注意事项
- QPS：单账号 QPS 不得超过 20。
- HTTP 请求超时时间：音频传输和声纹生成有一定的耗时，若需上传新的音频，建议您在发起 API 请求时，将 HTTP 请求超时时间设置为一个更宽裕的值，例如 15 秒或以上。
请求说明
- 请求方式：POST
- 请求地址：https://rtc.volcengineapi.com?Action=UpdateVoicePrint&Version=2024-12-01
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Query
Action String 必选 示例值：UpdateVoicePrint
接口名称。当前 API 的名称为 UpdateVoicePrint。
Version String 必选 示例值：2024-12-01
接口版本。当前 API 的版本为 2024-12-01。
Body
AppId String 必选 示例值：661e****543cf
VoicePrintId String 必选 示例值：20251125****_1740****9dc
Audio String 可选 示例值：UklGRiQ...AAAE=
新的声纹数据。经 Base64 编码后的整个 WAV 音频文件。必须满足如下要求：
- 音频格式：16kHz 采样率，16bit 位深，单声道。
- 音频数据大小：Base64 编码后的音频数据大小不得超过 2MB。
- 音频时长：音频总时长需在 15～30 秒之间，且有效语音（非静音部分）不得少于 12 秒。
注意
注册声纹使用的音频，其采集设备需要和客户真实通话时使用的音频采集设备保持一致，以保证最佳效果。
AudioFormat Integer 可选 示例值：0
音频格式。目前固定取值 0，表示 WAV 格式。
注意
如果传入了 Audio字段，此字段为必填。
AudioName String 可选 示例值：user_Alice_voice
新的自定义音频名称。如果传入，将覆盖原有名称。长度不超过 32 个字符。
AudioMetaInfo String 可选 示例值：Initial registration audio for user Alice
新的自定义元信息。如果传入，将覆盖原有信息。长度不超过 512 个字符。
Version Integer 可选 示例值：2
声纹算法版本。
- 1（默认值）：声纹算法 V1（PDNS）。
- 2（推荐）：声纹算法 V2（PVAD）。
返回参数
其中返回值 Result 仅在请求成功时返回 ok，失败时为空。
请求示例
POST https://rtc.volcengineapi.com?Action=UpdateVoicePrint&Version=2024-12-01
{
"AppId": "661e7ae5543cf",
"VoicePrintId": "20251125****_1740****9dc",
"Audio": "UklGRiQ...AAAE=",
"AudioFormat": 0,
"AudioName": "user_Alice_voice",
"AudioMetaInfo": "Initial registration audio for user Alice"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20250828110420****100232280022D31",
"Action": "UpdateVoicePrint",
"Version": "2024-12-01",
"Service": "rtc",
"Region": "cn-north-1"
},
"Result": "ok"
}
错误码
最近更新时间：2026.07.24 15:47:05
这个页面对您有帮助吗？
有用
有用
无用
无用