minimax/music/v2

Name: Minimax Music
Author: MiniMax

Music V2 by MiniMax - generate music, sound effects, and audio from text descriptions with AI. Create original compositions, ambient sounds, and audio content for any creative project.

Input

Prompt(string)

A description of the music, specifying style, mood, and scenario. 10-300 characters.

Lyrics Prompt(string)

Lyrics of the song. Use n to separate lines. You may add structure tags like [Intro], [Verse], [Chorus], [Bridge], [Outro] to enhance the arrangement. 10-3000 characters.

Audio Setting(string)

Audio configuration settings

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDminimax/music/v2

Input Schema

3 parameters · 1 required · 2 optional

Parameter	Type	Required	Description
`prompt`	string	Required	A description of the music, specifying style, mood, and scenario. 10-300 characters. · Min length: 10 · Max length: 2000
`audio_setting`	string	Optional	Audio configuration settings
`lyrics_prompt`	string	Optional	Lyrics of the song. Use n to separate lines. You may add structure tags like [Intro], [Verse], [Chorus], [Bridge], [Outro] to enhance the arrangement. 10-3000 characters. · Min length: 10 · Max length: 3000

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "minimax/music/v2",
  "prompt": "Indie folk, melancholic, introspective, longing, solitary walk, coffee shop",
  "lyrics_prompt": "[verse]Streetlights flicker, the night breeze sighsShadows stretch as I walk aloneAn old coat wraps my silent sorrow\nWandering, longing, where should I go[chorus]Pushing the wooden door, the aroma spreadsIn a familiar corner, a stranger gazes"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Minimax Music

API README

Minimax Music

Minimax Music turns a written musical brief into a complete generated song or instrumental track. The prompt can define genre, instrumentation, mood, energy, and listening scenario, while a separate lyrics field provides the words and high-level arrangement for vocal music.

The model is designed for composition rather than isolated sound effects or spoken narration. Section labels such as verse, chorus, bridge, and outro help organize longer pieces, making the route useful for demos, concept tracks, campaign music, and early exploration before a production team moves into detailed arrangement.

Highlights

Complete text-to-music generation. Creates a structured musical composition from genre, mood, instrumentation, and scenario direction.
Lyric-synchronized vocals. Connects supplied words to the vocal performance instead of treating lyrics as unrelated metadata.
Multi-section song structure. Uses arrangement labels to shape verses, choruses, bridges, intros, and outros.
Broad musical exploration. Supports contrasting genres, emotional arcs, and production directions for rapid concept development.

Pricing

Configuration	Billing unit	Price
Base generation	Per request	$0.03

When to Use

✅ Good fit	❌ Consider alternatives
The project needs drafting an original song	The goal is a different media task or endpoint
The available inputs match the required local schema	Required source media or permissions are unavailable
The brief can specify subject, composition, style, and delivery	The result must be deterministic at pixel or sample level
The supported formats and controls match final placement	Delivery requires unsupported dimensions, codecs, or duration
An asynchronous generated result fits the workflow	A live, frame-synchronous, or real-time response is mandatory

Prompt Guide

Write the request as a production brief: identify the main subject or source material, state the intended transformation, describe composition or timing, and finish with style, atmosphere, and delivery constraints. Keep preservation requirements separate from requested changes, and use only fields exposed by this route.

{
  "prompt": "A cinematic, precisely directed scene with clear subject action, camera movement, lighting, and atmosphere",
  "audio_setting": "https://example.com/reference.mp3",
  "lyrics_prompt": "example"
}

Technical Specs

Spec	Value
Model ID	`minimax/music/v2`
Input fields	`prompt` (string)<br>`audio_setting` (string)<br>`lyrics_prompt` (string)
Required input	`prompt`
Output fields	`url`, `content_type`
Execution	Asynchronous job

Related Models

minimax/speech/2.8/hd
minimax/speech/2.8/turbo
minimax/voice-clone