上传克隆音频

开发指南 API参考

模型价格模型发布

使用本接口上传用于克隆的音频文件。

POST/v1/files/upload

授权

Authorizationstringheader必填

HTTP: Bearer Auth

Security Scheme Type: http
HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在项目管理>API Key 中查看。

请求头

Content-Typeenum<string>默认值: multipart/form-data必填

请求体 multipart/form-data

purposeenum<string>必填

文件使用目的：

voice_clone：快速克隆原始文件

filebinary必填

需要上传的文件二进制数据。规范：

单声道 wav 格式；
时长最少应不低于 5 秒，最长应不超过 2 分钟。推荐时长 5-15 秒。

响应体结构

fileobject

file.file_idint64

文件唯一标识符（15位数字）

file.bytesint64

文件大小（字节）

file.created_atint64

创建时间 Unix 时间戳（毫秒）

file.filenamestring

文件名称

file.purposestring

文件使用目的，默认 voice_clone

base_respobject

base_resp.status_codeinteger

状态码：0=成功；100001=invalid params

base_resp.status_msgstring

状态详情

Upload Clone Audio

curl --request POST \
  --url https://maas-api.hivoice.cn/v1/files/upload \
  --header 'Authorization: Bearer <api_key>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'purpose=voice_clone' \
  --form 'file=@example.wav'

200

{
  "file": {
    "file_id": 871009177767936,
    "bytes": 1024,
    "created_at": 1773996915,
    "filename": "example.wav",
    "purpose": "voice_clone"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}