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>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://novita.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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