文档中心

实时音视频

请输入

声纹管理

查询声纹 ListVoicePrint

查询已注册的声纹信息。支持通过声纹 ID 列表精确查询，或分页查询指定 AppId 下的所有声纹。

精确查询：在 VoicePrintIdList 中提供最多 10 个声纹 ID。此模式下，分页参数 PageIndex 和 PageSize 不生效。

分页查询：不提供 VoicePrintIdList，使用 PageIndex 和 PageSize 进行分页浏览。

注意事项

单账号 QPS 不得超过 20。

请求说明

请求方式：POST

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

调试

API Explorer

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

去调试

请求参数

Query

Action String 必选示例值：ListVoicePrint

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

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

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

Body

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

应用 ID。获取地址：

AI 音视频互动方案-应用管理

实时对话式 AI-应用管理

VoicePrintIdList String[] 可选示例值：["202507**_**3ebd","202508**_**4ead"]

声纹 ID 列表，用于精确查询，可通过 ListVoicePrint 获取。数组长度不超过 10。默认为空。

如果通过此参数传入声纹 ID，分页参数不生效（PageSize 和 PageIndex）；不传则使用分页查询。

PageSize Integer 可选示例值：1

分页查询时的当前页码，从 1 开始。默认值为 1。

PageIndex Integer 可选示例值：20

分页查询时每页的条目数。

取值范围：[10, 100]。

默认值：20。

返回参数

TotalCount Integer 示例值：1

符合查询条件的总声纹数量。

Items Object[] 示例值：-

声纹的详细信息。

VoicePrintId String 示例值：202507**-**c3ebd

声纹 ID。

AudioName String 示例值：user_123_voice

注册时自定义的音频名称。

MetaInfo String 示例值：这是一个测试

注册时自定义的元信息。

CreatedAt Integer 示例值：1753103166

创建时间，Unix 时间戳（秒）。

UpdatedAt Integer 示例值：1753103166

最后更新时间，Unix 时间戳（秒）。

请求示例

POST https://rtc.volcengineapi.com?Action=ListVoicePrint&Version=2024-12-01​
{​
    "AppId": "66****cf",​
    "VoicePrintIdList": [​
        "202507**_**3ebd",​
        "202508**_**4ead"​
    ]​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20250828110420****100232280022D31",​
        "Action": "ListVoicePrint",​
        "Version": "2024-12-01",​
        "Service": "rtc",​
        "Region": "cn-north-1"​
    },​
    "Result": {​
        "TotalCount": 2,​
        "Items": [​
            {​
                "VoicePrintId": "202507**_**3ebd",​
                "AudioName": "user_123_voice",​
                "MetaInfo": "这是一个测试",​
                "CreatedAt": 1753103166,​
                "UpdatedAt": 1753103166​
            },​
            {​
                "VoicePrintId": "202508**_**4ead",​
                "AudioName": "user_456_voice",​
                "MetaInfo": "这是另一个测试",​
                "CreatedAt": 1753103167,​
                "UpdatedAt": 1753103167​
            }​
        ]​
    }​
}​

错误码

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

最近更新时间：2026.07.20 11:10:17

这个页面对您有帮助吗？

有用

无用