上传音频文件

POST

file/v1/audio/upload

V4.0

本接口主要提供语音文件上传功能，使用场景包括声纹注册、声纹确认、声纹辨认等。

音频文件需先调用该接口得到对应的fileId以进行后续的接口交互。

该接口支持多声道音频提取,会根据声道提取为多个fileId。

文件限制最大500M内。

请求参数

Header 参数

Content-Type

string

必需

示例值:

multipart/form-data

x-vai-token

string

业务Token

必需

Body 参数multipart/form-data

channel

string

必需

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

file

音频文件

必需

tracks

string

可选

声道数集
单声道音频无需传参；
双声道音频不传参或[]，该音频合并为单声道音频上传；传[0]、[1]、[0,1]代表分别上传对应声道的音频

示例值:

[0,1]

param

string

可选

当上传的音频为PCM格式时，需要填写该字段信息；
如为其他格式，该参数不需填写;
PCM格式只支持8000Hz采样率

示例值:

{“audioEncoding”: “PCM”, //音频编码枚PCM“rate”: 16000, //音频采样率“bits”:16, //采样位数“channel”: 1 //音频通道数}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'file/v1/audio/upload' \
--header 'x-vai-token;' \
--header 'Content-Type: multipart/form-data' \
--form 'channel=""' \
--form 'file=@""' \
--form 'tracks="[0,1]"' \
--form 'param="{“audioEncoding”: “PCM”, //音频编码枚PCM“rate”: 16000, //音频采样率“bits”:16, //采样位数“channel”: 1 //音频通道数}"'

返回响应

🟢200成功

application/json

Body

code

integer

错误码,0成功

必需

msg

string

错误消息

必需

rid

string

交易请求唯一标识

必需

data

array [object {2}] | null

返回数据

可选

channel

integer

声道,从0开始

必需

fileId

string

文件ID

必需

示例

{
    "code": 0,
    "msg": "string",
    "rid": "string",
    "data": [
        {
            "channel": 0,
            "fileId": "string"
        }
    ]
}

刷新TOKEN

下载音频文件