MiniMax 上传示例音频 API 文档

接口简介

使用本接口上传示例音频文件。使用示例音频有助于增强语音合成的音色相似度和稳定性。上传成功后获得 file_id，可用于后续语音合成。

请求地址与鉴权

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

请求参数

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

表单字段

参数名	类型	必填	说明	默认值	取值范围/格式
purpose	string	是	文件使用目的	prompt_audio	prompt_audio（示例音频，支持 mp3、m4a、wav）
file	binary	是	待上传的音频文件	-	见下方「文件规范」

文件规范

要求	说明
格式	mp3、m4a、wav
时长	小于 8 秒
文件大小	不超过 20 MB

请求示例

cURL

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

表单字段说明

• purpose：固定为 prompt_audio（示例音频）。
• file：表单字段名为 file，值为音频文件（mp3、m4a、wav）；时长小于 8 秒，大小不超过 20 MB。

响应格式

成功响应（application/json）

{
  "file": {
    "file_id": 123456789,
    "bytes": 5896337,
    "created_at": 1700469398,
    "filename": "sample.mp3",
    "purpose": "prompt_audio"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

• file.file_id：文件唯一标识，用于后续语音合成时引用示例音频。
• file.bytes：文件大小（字节）。
• file.created_at：创建时间，Unix 时间戳（秒）。
• file.filename：原始文件名。
• file.purpose：使用目的，此处为 prompt_audio。
• base_resp.status_code：0 表示成功，非 0 见下方错误码。

错误码（base_resp.status_code）

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