注册声纹 - 开放平台WebAPI V4.3.0

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

x-vai-token

string

业务Token

必需

Body 参数application/json

channel

string

必需

渠道编号(1-20个英文或数字)

files

array [object {2}]

必需

注册文件ID集（最多支持10个）

fileId

string

文件ID

必需

text

string

可选

进行语音识别的文本内容，和语音内容一致才能通过检测。

tagName

string

必需

声纹名，1-32位的数字、英文和下划线

tagInfo

string

可选

特征描述信息，长度最小为0，最大为256

groupId

string

必需

声纹库的标识，支持字母数字下划线，长度最大为32

needCheckInfo

boolean

可选

是否需要返回音频检查信息(质检)

示例

{
    "channel": "string",
    "files": [
        {
            "fileId": "string",
            "text": "string"
        }
    ],
    "tagName": "string",
    "tagInfo": "string",
    "groupId": "string",
    "needCheckInfo": true
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/openai/v1/tag/add' \
--header 'x-vai-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "channel": "string",
    "files": [
        {
            "fileId": "string",
            "text": "string"
        }
    ],
    "tagName": "string",
    "tagInfo": "string",
    "groupId": "string",
    "needCheckInfo": true
}'

返回响应

🟢200成功

application/json

Body

code

integer

错误码,0成功

必需

msg

string

错误消息

必需

rid

string

交易请求唯一标识

必需

data

object | null

返回数据

可选

status

integer

必需

任务状态 0 成功 1部分成功 300117 无有效音频 300011 同人检测不通过 300203 声纹名已存在 -9999 系统异常 -9998 算法服务异常

description

string

必需

status的文本描述

vpId

string

声纹ID

可选

vpName

string

声纹名

可选

checkInfo

array [object {5}]

音频检测信息集

可选

示例

{
    "code": 0,
    "msg": "string",
    "rid": "string",
    "data": {
        "status": 0,
        "description": "string",
        "vpId": "string",
        "vpName": "string",
        "checkInfo": [
            {
                "fileId": "string",
                "vadCheck": "string",
                "asvCheck": "string",
                "textMatch": "string",
                "isValid": 0
            }
        ]
    }
}