文档中心

实时音视频

请输入

声纹

注册声纹 IotVoicePrintRegister

调用本接口基于您提供的 WAV 文件，注册一个新的声纹。声纹用于智能体的声纹降噪配置（AgentConfig.VoicePrint）。

使用说明

QPS：单账号调用频率不得超过 20 次/秒。

您需要提供一段 Base64 编码的音频数据来注册声纹。

音频数据需满足以下要求：

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

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

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

为保证声纹降噪功能的最佳效果，建议您按以下提示录制音频数据：

使用与终端用户真实通话相同的音频采集设备来录制。

尽量在安静的场合录制。

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

请求说明

请求方式：POST

请求地址：https://rtc.volcengineapi.com?Action=IotVoicePrintRegister&Version=2025-08-01

请求参数

Query

Action String 必选示例值：IotVoicePrintRegister

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

Version String 必选示例值：2025-08-01

接口版本。当前 API 的版本为 2025-08-01。

Body

Audio String 必选示例值：UklGRqDPCgBXQVZFZm10IBAAAAABAAEAgD4AAAB9AAAEABAAZGF0YXzPCg...

Base64 编码后的 WAV 音频样本数据。

MetaInfo String 可选示例值：设备001_主用户_客厅

声纹的元信息，可包含设备、用户、场景等描述信息。

长度不超过 512 个字符。

AudioName String 必选示例值：user_Alice_voice

音频样本的名称。

长度不超过 32 个字符。

返回参数

UUID String 示例值：202511211731_8af1b4eb6cba4720a7e421e84a1c****

注册成功的声纹唯一标识符。

错误码

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

输入示例 1

输入示例

POST https://rtc.volcengineapi.com?Action=IotVoicePrintRegister&Version=2025-08-01

{
    "Audio": "UklGRqDPCgBXQVZFZm10IBAAAAABAAEAgD4AAAB9AAAEABAAZGF0YXzPCg...",
    "MetaInfo": "设备001_主用户_客厅",
    "AudioName": "user_Alice_voice"
}

输出示例

{
    "ResponseMetadata": {
        "Action": "IotVoicePrintRegister",
        "Region": "cn-north-1",
        "Service": "rtc",
        "Version": "2025-08-01",
        "RequestId": "20230604110420UHDI100232280022D31"
    },
    "Result": {
        "UUID": "202511211731_8af1b4eb6cba4720a7e421e84a1c****"
    }
}

最近更新时间：2026.07.18 23:50:58

这个页面对您有帮助吗？

有用

无用