上传示例音频

开发指南 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>必填

文件使用目的：

prompt_audio：声音克隆示例音频

filebinary必填

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

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

响应体结构

fileobject

file.file_idint64

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

file.bytesint64

文件大小（字节）

file.created_atint64

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

file.filenamestring

文件名称

file.purposestring

文件使用目的，默认 prompt_audio

base_respobject

base_resp.status_codeint64

状态码（0=正常；100001=参数错误；100101=鉴权失败；100501=触发 RPM 限流；100999=系统内部错误）

base_resp.status_msgstring

状态详情

Upload Prompt 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=prompt_audio' \
  --form 'file=@example.wav'

200

{
  "file": {
    "file_id": 123456789,
    "bytes": 1024,
    "created_at": 1699964873,
    "filename": "example.wav",
    "purpose": "prompt_audio"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}