Skip to main content
POST
/
v3
/
minimax-music
MiniMax Music
curl --request POST \
  --url https://api.novita.ai/v3/minimax-music \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model": "<string>",
  "lyrics": "<string>",
  "prompt": "<string>",
  "audio_setting": {
    "format": "<string>",
    "bitrate": 123,
    "sample_rate": 123
  },
  "output_format": "<string>",
  "aigc_watermark": true,
  "is_instrumental": true,
  "lyrics_optimizer": true
}
'
{
  "audios": [
    "<string>"
  ]
}
MiniMax AI music generation model, supporting creating AI music from text descriptions and lyrics across various styles, moods, and scenes

Request Headers

Content-Type
string
required
Supports: application/json
Authorization
string
required
Bearer authentication format, for example: Bearer {{API Key}}.

Request Body

model
string
required
Model version. music-2.5+ is the latest recommended version supporting instrumental generation; music-2.5 is the standard version; music-2.0 is the base versionOptional values: music-2.5+, music-2.5, music-2.0
lyrics
string
Song lyrics separated by \n. Supports structure tags: [Intro], [Verse], [Pre Chorus], [Chorus], [Interlude], [Bridge], [Outro], [Post Chorus], [Transition], [Break], [Hook], [Build Up], [Inst], [Solo]Length limit: 0 - 3500
prompt
string
Music description specifying style, mood, scene, etc. Required when is_instrumental is true (music-2.5+ only)Length limit: 0 - 2000
audio_setting
object
Audio parameter settings
output_format
string
default:"url"
Output format, fixed to url, returns audio linkOptional values: url
aigc_watermark
boolean
default:false
Whether to add AIGC watermark at the end of audio
is_instrumental
boolean
default:false
Generate instrumental music (no vocals). Only supported by music-2.5+, prompt is required when enabled
lyrics_optimizer
boolean
default:false
When enabled and lyrics is empty, automatically generates lyrics from prompt. Only supported by music-2.5 and music-2.5+

Response

audios
string[]
Generated audio list