MiniMax Music 3.0 API

Introduction

You send a style brief in prompt and, if you have them, the words to sing in lyrics; the model handles melody, arrangement and performance.

Key features

A whole song, not a loop

The result is a structured song with an intro, verses, a chorus that comes back and an ending, rather than a short repeating clip. The model sets the length itself, mostly from how many lyrics you give it, and mixes vocal and backing into one finished stereo file that is ready to play.

Three ways to handle the words

You can sing your own lyrics, have the model write them, or leave the singer out. Lyrics you provide are performed as written, and section tags such as [Verse] and [Chorus] steer the arrangement. With lyrics empty, generate_lyrics (on by default) writes a full set of lyrics from the prompt. With instrumental on, the track has no vocals at all.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Songs built around your own lyrics

Write the lyric sheet first, tag the sections, and describe the genre and voice you hear in your head. This suits personalised songs, character themes for stories and games, parody tracks and rough demos of a lyric you want to hear sung before taking it further.

Music for video and streams

Turn on instrumental for underscores, lounge beds and intro music, or keep the vocal for a title song.

Prompt guide & pro tips

Keep the style and the words apart

Use prompt for the sound only: genre, tempo in bpm, two or three instruments, the kind of voice and the mood, for example “dreamy synth-pop, 100 bpm, airy female lead vocal, shimmering pads, late-night city mood”. Put everything that should be sung in lyrics. Style words left in the lyrics tend to get sung.

Shape the song with section tags

Write one lyric line per row and put tags such as [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge] and [Outro] on their own rows. Repeat the chorus text where you want it to return. A verse and a chorus give a song of about a minute and a half; add verses and a bridge for a longer one.

Know what the filter stops

MiniMax checks prompts and lyrics.

API quick start

Call the MiniMax Music 3.0 API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model minimax/music-3.0/text-to-audio and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/music-3.0/text-to-audio",
  "input": {
    "prompt": "Calm ambient pads with a slow rising motif",
    "bitrate": 256000,
    "sample_rate": 44100
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

MiniMax Music 3.0 API questions

All MiniMax models

Suno v6 returns two versions per run for less, with tighter control over how lyrics are sung. MiniMax Music 3.0 tends to write longer songs and duets on its own.

• MiniMax H3 APIExpressive clips with audio, up to 2KFrom 28 credits for a 5-second clip
• MiniMax Speech 2.8 HD APIHigh-fidelity speech in 400+ voices with emotion controlFrom 18 credits per 1,000 characters
• MiniMax Music 3.0 APIFinished stereo songs, with vocals or instrumentalFrom 27 credits per run
• MiniMax H3 Singularity LoRA APICommunity-tuned H3 video that loads your own LoRAsFrom 45 credits for a 5-second clip
• MiniMax H3 Max APIFast clips with ambience, effects and musicFrom 38 credits for a 5-second clip
• MiniMax H3 LoRA APIMiniMax H3 video with sound and up to three of your LoRAsFrom 38 credits for a 5-second clip
• MiniMax H3 Image LoRA APIH3 stills and edits with up to three of your LoRAsFrom 7 credits per image
• MiniMax Speech 2.8 Turbo APIFast speech in 400+ voices with emotion controlFrom 11 credits per 1,000 characters

Other audio APIs

• Suno v6 APIFull songs with vocals from your lyrics or a short briefFrom 11 credits per run
• Suno v6 Mini APITwo quick songs with vocals from one sentenceFrom 11 credits per run
• Suno v6 Wild APIExperimental, textured songs with vocalsFrom 11 credits per run

More about MiniMax Music 3.0

Try it

MiniMax Music 3.0 AI Music Generator onlineCreate audio with MiniMax Music 3.0 in PopNow

Docs

MiniMax Music 3.0 model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesWebhooks: get MiniMax Music 3.0 results without polling