查询声纹

开发指南 API参考

Skill 文档模型价格 Token Plan 模型发布

查询当前账户下已注册的声纹信息。

POST/v1/vpr/query

授权

Authorizationstringheader必填

HTTP: Bearer Auth

Security Scheme Type: http
HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在按量计费&资源包>API Key 管理中查看。

请求头

Content-Typestring默认值: application/json必填

请求体application/json

describe_mode integer

查询方式：0 按 ID 查询，1 分页查询；默认 1。

page_index integer

当前页码，从 1 开始；describe_mode=1 时有效，默认 1。

page_size integer

每页条数；describe_mode=1 时有效，默认 20，最小 20。

feature_ids string[]

声纹 ID 列表；describe_mode=0 时必填。

响应体结构

total_count integer

符合条件的总条数；仅 describe_mode=1 时返回。

listarray<object>

声纹列表；无数据时为空数组 []。

list.feature_idstring

声纹 ID。

list.feature_infostring

备注信息。

list.audio_typestring

list.created_atstring

创建时间，格式 yyyy-MM-dd HH:mm:ss。

base_respobject

base_resp.status_codeinteger

状态码如下：

100001, 请求参数缺失/非法（如 audio_data、audio_type、feature_id、JSON 格式错误、音频格式/时长不符等）
100002, 更新时声纹不存在
100601, audio_data Base64 超过 5 MB
100999, 服务内部异常（含声纹引擎超时/提取失败、数据库异常等）

更多内容可查看错误码了解详情

base_resp.status_msgstring

状态描述

Describe VPR (Page)

curl --request POST \
  --url https://maas-api.unisound.com/v1/vpr/query \
  --header 'Authorization: Bearer <api_key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "page_index": 1,
  "page_size": 20
}'

200

{
  "total_count": 2,
  "list": [
    {
      "feature_id": "vpr_20250625_abc123def456",
      "feature_info": "张三",
      "audio_type": "wav",
      "created_at": "2025-06-25 14:30:00"
    },
    {
      "feature_id": "vpr_20250625_def789ghi012",
      "feature_info": "李四",
      "audio_type": "wav",
      "created_at": "2025-06-25 10:00:00"
    }
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}