Upload an audio sample

Upload an audio sample and obtain its file_id. Voice-cloning samples and auxiliary audio used to improve similarity use different purpose values.

POST/v1/minimax/files/upload

Upload a voice-cloning sample or a prompt audio file that improves voice similarity, and obtain the file ID required by the voice-cloning API.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization header.

In: header

Request Body

multipart/form-data

Upload the audio file as multipart form data. Let the client library generate the Content-Type boundary automatically.

TypeScript Definitions

Use the request body type in TypeScript.

file*file

MP3, M4A, or WAV audio to upload. The file must be 10 seconds to 5 minutes long and no larger than 20 MB.

Formatbinary

purpose?string

Upload purpose. Use voice_clone for a voice sample and prompt_audio for prompt audio that improves voice similarity.

Default"voice_clone"

Value in

"voice_clone"
"prompt_audio"

Response Body

`application/json`

curl -X POST "https://example.com/v1/minimax/files/upload" \  -F file="voice_sample.mp3" \  -F purpose="voice_clone"

{
  "file": {
    "file_id": 2305843009214732,
    "bytes": 1048576,
    "created_at": 1717220000,
    "filename": "voice_sample.mp3",
    "purpose": "voice_clone"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Authorization

Request Body

Response Body

200application/json

401application/json

`application/json`

`application/json`