文档中心

实时音视频

请输入

声纹

删除声纹 IotVoicePrintDelete

调用本接口删除一个已注册的声纹。

使用说明

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

注意事项

删除声纹前，请确保目标声纹没有用于智能体的声纹降噪配置（AgentConfig.VoicePrint），否则将导致智能体无法启动会话。

声纹删除后无法恢复，请谨慎操作。

请求说明

请求方式：POST

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

请求参数

Query

Action String 必选示例值：IotVoicePrintDelete

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

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

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

Body

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

要删除的声纹的唯一标识符。

说明

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

返回参数

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

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

错误码

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

输入示例 1

输入示例

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

{
    "UUID": "202511211731_8af1b4eb6cba4720a7e421e84a1c****"
}

输出示例

{
    "ResponseMetadata": {
        "Action": "IotVoicePrintDelete",
        "Region": "cn-north-1",
        "Service": "rtc",
        "Version": "2025-08-01",
        "RequestId": "20230604110420****100232280022D31"
    }
}

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

这个页面对您有帮助吗？

有用

无用