文档中心

实时音视频

请输入

声纹

更新声纹 IotVoicePrintUpdate

调用本接口更新一个已注册声纹的信息，如修改音频样本、声纹元信息等。

使用说明

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

如需替换音频样本，您需要提供一段新的 Base64 编码的音频数据。

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

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

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

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

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

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

尽量在安静的场合录制。

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

请求说明

请求方式：POST

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

请求参数

Query

Action String 必选示例值：IotVoicePrintUpdate

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

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

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

Body

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

要更新的声纹的唯一标识符。

说明

您可以调用 IotVoicePrintQuery接口获取所有声纹的 UUID。

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

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

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

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

长度不超过 512 个字符。

AudioName String 可选示例值：user_Bob_voice

音频样本的名称。

长度不超过 32 个字符。

返回参数

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

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

错误码

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

输入示例 1

输入示例

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

{
    "UUID": "202511211731_8af1b4eb6cba4720a7e421e84a1c****",
    "Audio": "UklGRqDPCgBXQVZFZm10IBAAAAABAAEAgD4AAAB9AAAEABAAZGF0YXzPCg...",
    "MetaInfo": "设备001_主用户_客厅",
    "AudioName": "user_Bob_voice"
}

输出示例

{
    "ResponseMetadata": {
        "Action": "IotVoicePrintUpdate",
        "Region": "cn-north-1",
        "Service": "rtc",
        "Version": "2025-08-01",
        "RequestId": "202306041104208594100232280022D31"
    }
}

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

这个页面对您有帮助吗？

有用

无用