主题模式

MiniMax 上传复刻音频 API 文档 ​

文档索引 ​

完整文档索引请访问：https://platform.minimaxi.com/docs/llms.txt
使用该文件发现所有可用页面后再进一步查阅。

接口简介 ​

使用本接口上传用于复刻音色的音频文件。上传成功后获得 file_id，可用于语音合成时的复刻音色。

请求地址与鉴权 ​

项目说明
请求方法POST
请求地址/v1/audio/minimax/voices/upload
Content-Typemultipart/form-data（由客户端自动带 boundary，也可不显式设置）
鉴权方式Authorization: Bearer {api_key}

请求参数 ​

请求体为 multipart/form-data，字段如下。

表单字段 ​

参数名类型必填说明默认值取值范围/格式
purposestring是文件使用目的voice_clonevoice_clone（快速复刻，支持 mp3、m4a、wav）
filebinary是待上传的音频文件-见下方「文件规范」

文件规范 ​

要求说明
格式mp3、m4a、wav
时长不少于 10 秒，不超过 5 分钟
文件大小不超过 20 MB

请求示例 ​

cURL ​

bash
curl -X POST "https://aiping.cn/api/v1/audio/minimax/voices/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "purpose=voice_clone" \
  -F "file=@/path/to/your/audio.mp3"

表单字段说明 ​

  • purpose：固定为 voice_clone（快速复刻）。
  • file：表单字段名为 file，值为音频文件（mp3、m4a、wav）；时长 10 秒～5 分钟，大小不超过 20 MB。

响应格式 ​

成功响应（application/json） ​

json
{
  "file": {
    "file_id": 123456789,
    "bytes": 5896337,
    "created_at": 1700469398,
    "filename": "复刻音频",
    "purpose": "voice_clone"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}
  • file.file_id：文件唯一标识，用于语音合成时指定复刻音色。
  • file.bytes：文件大小（字节）。
  • file.created_at：创建时间，Unix 时间戳（秒）。
  • file.filename：原始文件名。
  • file.purpose：使用目的，此处为 voice_clone。
  • base_resp.status_code：0 表示成功，非 0 见下方错误码。

错误码（base_resp.status_code） ​

状态码说明
0请求成功
1002触发限流，请稍后再试
1004账号鉴权失败，请检查 API Key 是否填写正确
1008账号余额不足
1026图片描述涉及敏感内容
2013传入参数异常，请检查入参是否按要求填写
2049无效的 API Key