Skip to content

MiniMax Music 3

Integrate

Model id minimax/music-3
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/music-3?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Warm indie folk, acoustic guitar and soft brushed drums, gentle female vocal, 92 BPM, nostalgic summer evening",
    "lyrics": "[verse]\nPorch lights humming on the edge of town\nWe count the fireflies as the sun goes down\n[chorus]\nStay a little longer, the night is young\nSing me the song that we never sung",
    "duration": 30
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.06 60 API credits Run it on this page

Get API key

Examples

Output · ~84 s

PromptWarm indie folk, acoustic guitar and soft brushed drums, gentle female vocal, 92 BPM, nostalgic summer evening

30 s$0.06 · 60 API credits

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required

Music-generation prompt that can use a Structured Caption for precise control: combine section-specific arrangement and vocal details with global metadata specifying genre, BPM, key, and emotional progression. A general description covers the desired style and mood, how vocals and instruments are used, and the arrangement.

•required

Lyrics to be sung; any words sharing a line with a leading structure tag are discarded under the model's input contract. Keep each tag on a separate line, including [intro], [verse], [pre-chorus], [chorus], [post-chorus], [bridge], [instrumental], [solo] and [outro].

Audio duration limit, measured in seconds, rather than a guaranteed output length. The response reports the actual duration, which can be shorter if generation stops early.

Advanced num_inference_steps · guidance_scale · seed
default 30

Euler step count for flow matching within each 8-second denoising chunk.

default 1.7

Classifier-free guidance strength during flow matching.

Seed for reproducible generation, chosen randomly unless you supply a value.

POST /run/minimax/music-3?wait=20 quote → $0.06
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/music-3?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Warm indie folk, acoustic guitar and soft brushed drums, gentle female vocal, 92 BPM, nostalgic summer evening",
    "lyrics": "[verse]\nPorch lights humming on the edge of town\nWe count the fireflies as the sun goes down\n[chorus]\nStay a little longer, the night is young\nSing me the song that we never sung",
    "duration": 30
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About MiniMax Music 3

MiniMax Music 3 sings your lyrics over a complete arrangement. Describe genre, tempo, key, mood, vocals and instruments in the prompt and mark the song structure in the lyrics with tags such as [verse], [chorus] and [bridge], each on its own line. The duration (1 to 300 seconds, 60 by default) is an upper bound; the song may end earlier.

Parameters

NameType DefaultAllowed Description
promptrequired
Typestring
Music-generation prompt that can use a Structured Caption for precise control: combine section-specific arrangement and vocal details with global metadata specifying genre, BPM, key, and emotional progression. A general description covers the desired style and mood, how vocals and instruments are used, and the arrangement.
lyricsrequired
Typestring
Lyrics to be sung; any words sharing a line with a leading structure tag are discarded under the model's input contract. Keep each tag on a separate line, including [intro], [verse], [pre-chorus], [chorus], [post-chorus], [bridge], [instrumental], [solo] and [outro].
durationoptional
Typenumber
Default60
1 – 300
Audio duration limit, measured in seconds, rather than a guaranteed output length. The response reports the actual duration, which can be shorter if generation stops early.
seedoptional
Typeinteger | null
Seed for reproducible generation, chosen randomly unless you supply a value.
num_inference_stepsoptional
Typeinteger
Default30
1 – 100
Euler step count for flow matching within each 8-second denoising chunk.
guidance_scaleoptional
Typenumber
Default1.7
0 – 20
Classifier-free guidance strength during flow matching.
required

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "minimax/music-3",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "Genre: acoustic pop. BPM: 96. Key: C major. Warm and intimate, soft female vocal, guitar and light piano",
    "lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
    "duration": 30
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "seed": 42,
    "duration": 5
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
audio
object {url, content_type, file_name, file_size}Output audio file in stereo WAV format, using 44.1 kHz and 16-bit samples.
seed
integerRandom seed used during generation.
duration
numberReports how many seconds of audio were actually generated, which is not necessarily as long as requested.

More models: Text to Music

For AI agents: this page as Markdown is at https://doitong.com/developers/models/minimax/music-3.md. All models and guides: https://doitong.com/developers/llms.txt