文档中心

实时音视频

请输入

声纹

查询声纹 IotVoicePrintQuery

调用本接口查询已注册声纹的信息。支持通过声纹 ID 列表精确查询，或查询所有声纹。

使用说明

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

请求说明

请求方式：POST

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

请求参数

Query

Action String 必选示例值：IotVoicePrintQuery

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

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

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

Body

UUIDs String[] 可选示例值：["202511211731_8af1b4eb6cba4720a7e421e84a1c****"]

声纹 ID 列表，用于精确查询。数组长度不超过 10。不传时默认查询所有声纹。

Limit Integer 可选示例值：50

每页返回的最大结果数量。取值范围：1~200。默认值：50。

Iterator String 可选示例值：202511211731_8af1b4eb6cba4720a7e421e84a1c****

分页标识。传入上一次查询结果中的 NextIterator 值，以获取下一页数据。首次查询时无需传入。

返回参数

VoicePrints Object[]

声纹对象数组。

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

声纹唯一标识符。

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

声纹元信息。

AccountID String 示例值：210015XXXX

火山引擎账户 ID。

AudioName String 示例值：user_Alice_voice

音频样本名称。

CreatedAt Long 示例值：1640995200000

声纹创建时间。使用 Unix 时间戳格式，单位：毫秒。

UpdatedAt Long 示例值：1640995200000

声纹最后更新时间。使用 Unix 时间戳格式，单位：毫秒。

VoicePrint String 示例值：ojlRvnl/Zj0SBck9FSjoPVKRNb5bmg++KYuWvUfaNL78U08+perPPcVG/j4StBa+hNNdvQMvkT7MJuS8mSFcvQYy4T0UUIa+ZLVdPgk2LT0/...

声纹特征数据。

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

下一页的分页标识。如果为空字符串，表示已是最后一页。

错误码

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

输入示例 1

输入示例

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

{
    "Limit": 1,
    "UUIDs": [
        "202511211731_8af1b4eb6cba4720a7e421e84a1c****",
        "202511211741_3c2717e0ac7b443991c0322c2a48****"
    ],
    "WithTotalCount": true
}

输出示例

{
    "ResponseMetadata": {
        "Action": "IotVoicePrintQuery",
        "Region": "cn-north-1",
        "Service": "rtc",
        "Version": "2025-08-01",
        "RequestId": "20230604110420****100232280022D31"
    },
    "Result": {
        "VoicePrints": [
            {
                "UUID": "202511211731_8af1b4eb6cba4720a7e421e84a1c****",
                "MetaInfo": "设备001_主用户_客厅",
                "AccountID": "210015XXXX",
                "AudioName": "user_Alice_voice",
                "CreatedAt": 1640995200000,
                "UpdatedAt": 1640995200000,
                "VoicePrint": "ojlRvnl/Zj0SBck9FSjoPVKRNb5bmg++KYuWvUfaNL78U08+perPPcVG/j4StBa+hNNdvQMvkT7MJuS8mSFcvQYy4T0UUIa+ZLVdPgk2LT0/..."
            }
        ],
        "NextIterator": "202511211731_8af1b4eb6cba4720a7e421e84a1c****"
    }
}

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

这个页面对您有帮助吗？

有用

无用