Upload audio (Minimax Music)

API Reference

POST/v2/generate/audio/minimax/upload

Body

application/json

purpose*enum

1. If purpose is song:

• You need to upload a music file containing both acapella (vocals) and accompaniment.
• The acapella must be in singing form; normal speech is not supported.
• Outputs: voice_id and instrumental_id.

2. If purpose is voice:

• You need to upload a file containing only acapella in singing form (normal speech audio is not supported).
• Output: voice_id.

3. If purpose is instrumental:

• You need to upload a file containing only accompaniment.
• Output: instrumental_id.

songvoiceinstrumental

Response

default

Body

application/json

voice_idstring

The voice_id will only be returned when the purpose is song or voice.

Example: "vocal-2025011003141025-d5ZEMxmp"

instrumental_idstring

The instrumental_id will only be returned when the purpose is song or instrumental.

Example: "instrumental-2025011003141125-Akz9eWnD"

base_resp*object

Request

JavaScriptCurlPython

const response = await fetch('/v2/generate/audio/minimax/upload', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "purpose": "song"
    }),
});
const data = await response.json();

Response

default

{
  "voice_id": "vocal-2025011003141025-d5ZEMxmp",
  "instrumental_id": "instrumental-2025011003141125-Akz9eWnD",
  "base_resp": {
    "status_code": 0,
    "status_msg": "text"
  }
}

Examples

JavaScript

// npm install node-fetch form-data
import fs from "fs";
import path from "path";
import fetch from "node-fetch";
import FormData from "form-data";

const upload = async () => {
  const url = "https://api.aimlapi.com/v2/generate/audio/minimax/upload";
  const fileName = "filename.mp3";
  const filePath = path.resolve(fileName); // Path to your file

  const purpose = "song"; // Possible values: "song", "voice", "instrumental"

  const formData = new FormData();
  formData.append("purpose", purpose);
  formData.append("file", fs.createReadStream(filePath), {
    filename: fileName,
    contentType: "audio/mpeg",
  });

  const apiKey = "<YOUR_API_KEY>"; 

  try {
    const response = await fetch(url, {
      method: "POST",
      headers: {
        Authorization: `Bearer ${apiKey}`,
        ...formData.getHeaders(),
      },
      body: formData,
    });

    if (response.ok) {
      const data = await response.json();
      console.log("Upload successful:", data);
    } else {
      console.error("Upload failed:", response.status, await response.text());
    }
  } catch (error) {
    console.error("Error during upload:", error.message);
  }
}

upload();

Python

import requests

def upload():
    api_key = '<YOUR_API_KEY>'
    url = 'https://api-staging.aimlapi.com/v2/generate/audio/minimax/upload'
    file_name = 'file_name.mp3'
    # Your path to the song
    file_path = 'file_path.mp3'

    purpose = 'song' # Possible values: 'song', 'voice', 'instrumental'

    payload = {
        'purpose': purpose,
    }
    files = [
        ('file', (file_name, open(file_path, 'rb'), 'audio/mpeg'))
    ]
    headers = {
        'authorization': 'Bearer ' + api_key,
    }

    response = requests.request('POST', url, headers=headers, data=payload, files=files)
    print(response.json())

if __name__ == '__main__':
    upload()

Upload file with link

JavaScript

// npm install node-fetch form-data
import fs from "fs";
import path from "path";
import fetch from "node-fetch";
import FormData from "form-data";

const upload = async () => {
  const url = "https://api.aimlapi.com/v2/generate/audio/minimax/upload";
  const audioUrl = "url_to_file.mp3";  // Replace with the actual URL of the file
  const fileName = "filename.mp3";  // The name you want to give to the uploaded file
  const purpose = "song"; // Possible values: "song", "voice", "instrumental"

  const apiKey = "<YOUR_API_KEY>";  // Replace with your actual API key

  try {
  // Download the file from the URL
  const response = await fetch(audioUrl);
  if (!response.ok) {
    throw new Error(`Failed to fetch file from URL: ${audioUrl}`);
  }
  
  const fileBuffer = await response.arrayBuffer(); // Get the file as a buffer

  // Upload the file to the server using FormData
  const formData = new FormData();
  formData.append("purpose", purpose);
  formData.append("file", Buffer.from(fileBuffer), {
    filename: fileName,
    contentType: "audio/mpeg",
  });

  const uploadResponse = await fetch(url, {
    method: "POST",
    headers: {
    Authorization: `Bearer ${apiKey}`,
    ...formData.getHeaders(),
    },
    body: formData,
  });

  if (uploadResponse.ok) {
    const data = await uploadResponse.json();
    console.log("Upload successful:", data);
  } else {
    console.error("Upload failed:", uploadResponse.status, await uploadResponse.text());
  }
  } catch (error) {
  console.error("Error during upload:", error);
  }
};

upload();

Python

import requests

def upload():
    url = 'https://api.aimlapi.com/v2/generate/audio/minimax/upload'
    audio_url = 'url_to_file.mp3'  # Replace with the actual URL of the file
    file_name = 'filename.mp3'  # The name you want to give to the uploaded file
    purpose = 'song'  # Possible values: 'song', 'voice', 'instrumental'

    api_key = '<YOUR_API_KEY>'  # Replace with your actual API key

    try:
        # Step 1: Download the file from the URL
        response = requests.get(audio_url)
        if response.status_code != 200:
            print(f'Failed to download file from URL: {audio_url}')
            return
        
        payload = {
            'purpose': purpose,
        }
        # Step 2: Upload the file to the server
        files = {
            'file': (file_name, response.content, 'audio/mpeg')  # File content as bytes
        }
        headers = {
            'Authorization': f'Bearer {api_key}'
        }

        upload_response = requests.post(url, headers=headers, files=files, data=payload)

        if upload_response.status_code == 200:
            data = upload_response.json()
            print('Upload successful:', data)
        else:
            print('Upload failed:', upload_response.status_code, upload_response.text)
    
    except requests.exceptions.RequestException as error:
        print(f'Error during upload: {error}')

if __name__ == '__main__':
    upload()