music-01

This documentation is valid for the following list of our models:

• music-01

Model Overview

An advanced AI model that generates diverse high-quality audio compositions by analyzing and reproducing musical patterns, rhythms, and vocal styles from the reference track. Refine the process using a text prompt.

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

Submit a request

API Schema

post

Authorizations

Body

purposestring · enumrequired

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.

Options: song, voice, instrumental

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.aimlapi.com/v2/generate/audio/minimax/upload' \
  --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "purpose": "song"
  }'

default

default

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

post

Authorizations

Body

all of

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.aimlapi.com/v2/generate/audio/minimax/generate' \
  --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "lyrics": "##Swift and Boundless \n In the realm of innovation, where visions align, \n\nAIML API's the name, making tech shine. \nIntelligent solutions, breaking the mold, \n\nSwift inference power, bold and untold.\n##",
    "model": "music-01",
    "audio_setting": {
      "sample_rate": 16000,
      "bitrate": 32000,
      "format": "mp3"
    },
    "refer_voice": "vocal-2025010100000000-a0AAAaaa",
    "refer_instrumental": "instrumental-2025010100000000-Aaa0aAaA"
  }'

default

default

{
  "data": {
    "status": 1,
    "audio": "text"
  },
  "extra_info": {
    "audio_length": 1,
    "audio_size": 1,
    "audio_bitrate": 1,
    "audio_sample_rate": 1
  },
  "trace_id": "text",
  "base_resp": {
    "status_code": 1,
    "status_msg": "text"
  }
}