文档中心

实时音视频

请输入

声纹管理

注册声纹 RegisterVoicePrint

通过上传一段 WAV 格式的音频来注册声纹并返回声纹 ID，可用于声纹降噪或声纹识别。

注意事项

QPS：单账号 QPS 不得超过 20。

HTTP 请求超时时间：音频传输和声纹生成有一定的耗时，建议您在发起 API 请求时，将 HTTP 请求超时时间设置为一个更宽裕的值，例如 15 秒或以上。

请求说明

请求方式：POST

请求地址：https://rtc.volcengineapi.com?Action=RegisterVoicePrint&Version=2024-12-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Query

Action String 必选示例值：RegisterVoicePrint

接口名称。当前 API 的名称为 RegisterVoicePrint。

Version String 必选示例值：2024-12-01

接口版本。当前 API 的版本为 2024-12-01。

Body

AppId String 必选示例值：66****cf

你的音视频应用的唯一标识，参看获取 AppId。

AudioName String 必选示例值：user_Alice_voice

自定义音频名称，用于标识该声纹。长度不超过 32个字符。

AudioFormat Integer 必选示例值：0

音频格式。目前固定取值 0，表示 WAV 格式。

Audio String 必选示例值：UklGRiQ...AAAE=

经 Base64 编码后的整个 WAV 音频文件。必须满足如下要求：

音频格式：16kHz 采样率，16bit 位深，单声道。

音频数据大小：Base64 编码后的音频数据大小不得超过 2MB。

音频时长：音频总时长需在 15～30 秒之间，且有效语音（非静音部分）不得少于 12 秒。

注意

注册声纹使用的音频，其采集设备需要和客户真实通话时使用的音频采集设备保持一致，以保证最佳效果。

尽量在安静环境下采集清晰人声，以保障声纹注册质量和后续识别效果。

AudioMetaInfo String 可选示例值：Initial registration audio for user Alice

自定义元信息，可用于存储备注等。长度不超过 512 个字符。

Version Integer 可选示例值：2

声纹算法版本。

1（默认值）：声纹算法 V1（PDNS）。

2（推荐）：声纹算法 V2（PVAD）。

返回参数

本接口无特有的返回参数。公共返回参数请见返回结构。

其中返回值 Result 仅在请求成功时返回声纹 ID，失败时为空。

请求示例

POST https://rtc.volcengineapi.com?Action=RegisterVoicePrint&Version=2024-12-01​
{​
    "AppId": "661e****543cf",​
    "AudioName": "user_123_voice_sample",​
    "AudioFormat": 0,​
    "Audio": "UklGRiQ...AAAE="​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20250828110420****100232280022D31",​
        "Action": "RegisterVoicePrint",​
        "Version": "2024-12-01",​
        "Service": "rtc",​
        "Region": "cn-north-1"​
    },​
    "Result": "20251125****_1740****9dc"​
}​

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2026.08.28 16:18:24

这个页面对您有帮助吗？

有用

无用