Music

Music Generation

Generate original music tracks from text prompts or lyrics using MiniMax's music-01 model.

POST/v1/music/generations

Request

Body Parameters

modelstringrequired

Model ID, use "music-01"

promptstring

Text description of desired music style and mood

lyricsstring

Song lyrics to set to music (use with vocal tracks)

refer_voicestring

Voice ID for vocal style reference

refer_instrumentalstring

File ID for instrumental style reference

audio_settingobject

Output configuration (sample_rate, bitrate, format)

Provide either prompt for instrumental/mood-based generation, or lyrics for vocal music.
cURL
curl https://api.metriqual.com/v1/music/generations \
  -H "Authorization: Bearer mql_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "music-01",
    "prompt": "An upbeat electronic pop track with synths",
    "audio_setting": {
      "sample_rate": 44100,
      "bitrate": 256000,
      "format": "mp3"
    }
  }'
TypeScript SDK
const music = await mql.music.generate({
  model: 'music-01',
  prompt: 'An upbeat electronic pop track with synths',
  audio_setting: {
    sample_rate: 44100,
    bitrate: 256000,
    format: 'mp3'
  }
});

// Download the generated track
console.log(music.data.audio_url);
Python SDK
music = mql.music.generate(
    model="music-01",
    prompt="An upbeat electronic pop track with synths",
    audio_setting={
        "sample_rate": 44100,
        "bitrate": 256000,
        "format": "mp3",
    },
)
print(music["data"]["audio_url"])

# Convenience methods
music = mql.music.generate_from_prompt("Lo-fi chill beats")
music = mql.music.generate_with_lyrics("Pop ballad", "[Verse 1]\nHello world...")

Response

200
{
  "request_id": "req_music_abc123",
  "data": {
    "audio_url": "https://api.metriqual.com/storage/music/abc123.mp3",
    "duration": 30.5
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}
Next
Quick Start