MiniMax Music Cover
MiniMax Music Cover is MiniMax’s song-to-song transformation model for reimagining an existing track in a new style. It preserves the original vocal melody while changing voice timbre, instrumentation, genre, and arrangement through a text prompt. It supports one-step generation from reference audio or a two-step workflow with preprocessing and optional lyric editing.
API Options
Platform-level options for task execution and delivery.
-
taskType
string required value: audioInference -
Identifier for the type of task being performed
-
taskUUID
string required UUID v4 -
UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.
-
outputType
string default: URL -
Audio output type.
Allowed values 3 values
-
outputFormat
string default: MP3 -
Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.
- `MP3`: Compressed audio, smaller file size.
- `WAV`: Uncompressed, high-quality audio.
- `FLAC`: Lossless compression.
- `OGG`: Open-source compressed audio format (Vorbis codec).
Allowed values 4 values
-
audioSettings
object -
Audio encoding settings for controlling the bitrate, number of channels, and sample rate of the generated audio. Only applicable for lossy output formats (
MP3andOGG). When using lossless formats (WAVorFLAC), this parameter must not be provided.The available sample rates and valid bitrate ranges depend on the output format. For
OGG, bitrate limits also vary by the number of channels.MP3 bitrate limits
Bitrate limits for MP3 are the same regardless of mono or stereo.
Sample Rate Min Bitrate Max Bitrate 8,000 Hz 8 kbps 64 kbps 11,025 Hz 8 kbps 64 kbps 12,000 Hz 8 kbps 64 kbps 16,000 Hz 8 kbps 160 kbps 22,050 Hz 8 kbps 160 kbps 24,000 Hz 8 kbps 160 kbps 32,000 Hz 32 kbps 320 kbps 44,100 Hz 32 kbps 320 kbps 48,000 Hz 32 kbps 320 kbps OGG bitrate limits — Mono (1 channel)
Sample Rate Min Bitrate Max Bitrate 8,000 Hz 8 kbps 40 kbps 12,000 Hz 16 kbps 48 kbps 16,000 Hz 16 kbps 96 kbps 24,000 Hz 16 kbps 80 kbps 48,000 Hz 32 kbps 224 kbps OGG bitrate limits — Stereo (2 channels)
Sample Rate Min Bitrate Max Bitrate 8,000 Hz 16 kbps 80 kbps 12,000 Hz 16 kbps 96 kbps 16,000 Hz 24 kbps 192 kbps 24,000 Hz 32 kbps 160 kbps 48,000 Hz 48 kbps 256 kbps Lossless formats: When
outputFormatis set toWAVorFLAC, theaudioSettingsparameter is not available since these formats produce uncompressed or lossless audio with no configurable encoding settings.Properties 3 properties
-
audioSettings»bitratebitrate
integer min: 8 -
Audio bitrate in kbps.
-
audioSettings»channelschannels
integer default: 2 -
Number of audio channels. 1 for mono, 2 for stereo.
Allowed values 2 values
-
audioSettings»sampleRatesampleRate
integer -
Audio sample rate in Hz.
-
-
webhookURL
string URI -
Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.
Learn more 1 resource
- Webhooks PLATFORM
- Webhooks
-
deliveryMethod
string default: sync -
Determines how the API delivers task results.
Allowed values 2 values
- Returns complete results directly in the API response.
- Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.
Learn more 1 resource
- Task Polling PLATFORM
-
uploadEndpoint
string URI -
Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.
Common use cases:
- Cloud storage: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- CDN integration: Upload to content delivery networks for immediate distribution.
// S3 presigned URL for secure upload https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600 // Google Cloud Storage presigned URL https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789 // Custom storage endpoint https://storage.example.com/uploads/generated-image.jpgThe content data will be sent as the request body to the specified URL when generation is complete.
-
ttl
integer min: 60 -
Time-to-live (TTL) in seconds for generated content. Only applies when
outputTypeisURL.
-
includeCost
boolean default: false -
Include task cost in the response.
-
numberResults
integer min: 1 max: 4 default: 1 -
Number of results to generate. Each result uses a different seed, producing variations of the same parameters.
Inputs
Input resources for the task (images, audio, etc). These must be nested inside the inputs object.
inputs object.-
inputs»audioaudio
string required -
Audio input (UUID or URL). The provided audio file must be between 6 seconds and 6 minutes in duration.
Generation Parameters
Core parameters for controlling the generated content.
-
model
string required value: minimax:music@cover -
Identifier of the model to use for generation.
Learn more 3 resources
-
positivePrompt
string required min: 10 max: 300 -
Text prompt describing elements to include in the generated output.
Learn more 2 resources
-
seed
integer min: 0 max: 1000000 -
Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.
Learn more 1 resource
Settings
Technical parameters to fine-tune the inference process. These must be nested inside the settings object.
settings object.-
settings»lyricslyrics
string min: 10 max: 1000 -
Structured lyrics with section tags such as [Intro], [Verse], [Chorus], [Bridge], [Outro], and [Inst]. For instrumental generation, a tag-only skeleton is acceptable.
Chrome Disco Boxing Gym
{
"taskType": "audioInference",
"taskUUID": "c3ee9e55-851c-4e69-9461-82c2e8dce4f2",
"model": "minimax:music@cover",
"positivePrompt": "Transform this song into a sleek late-70s inspired funk-pop cover set in a glamorous boxing gym: bright female lead timbre, tight disco drums, elastic bassline, crisp rhythm guitar, bold brass stabs, crowd chants, sparkling synth accents, dramatic breakdown, triumphant final chorus.",
"seed": 74885,
"settings": {
"lyrics": "[Intro]\n[Verse]\nGloves on the bench, heartbeat in the wire\nNeon on the ropes, sweat turning into fire\nEverybody counts when the bell cuts through the room\nI came here to bloom\n\n[Chorus]\nHit me with the spotlight, stronger every round\nTurn the pressure into gold, let the whole floor pound\nWhen they call my name, I rise above the doubt\nI was born to break out\n\n[Verse]\nMirror on the wall, flashes from the tape\nFootwork like a promise nobody can reshape\nBruises become glitter when the rhythm takes control\nBody, mind, and soul\n\n[Bridge]\nOne more step, one more swing\nHear the horns and feel the ring\n[Chorus]\n[Outro]"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/e37c876f-c35c-46cd-8bea-831881e3652f.mp3"
}
}{
"taskType": "audioInference",
"taskUUID": "c3ee9e55-851c-4e69-9461-82c2e8dce4f2",
"audioUUID": "39ae7787-e219-40cf-b84b-1845e6d419d5",
"audioURL": "https://am.runware.ai/audio/os/a01d21/ws/5/ai/39ae7787-e219-40cf-b84b-1845e6d419d5.mp3",
"seed": 74885,
"cost": 0.15
}Basement Gospel Breakbeat Revival
{
"taskType": "audioInference",
"taskUUID": "b924b635-7802-43f2-a48d-fe0e0ce2053b",
"model": "minimax:music@cover",
"positivePrompt": "Transform this demo into a raw gospel-breakbeat cover with punchy chopped drums, Hammond organ, handclaps, tambourine, soulful backing choir, vinyl grit, dynamic rises, and a triumphant live-room feel while keeping the lead vocal melody intact.",
"seed": 33183,
"settings": {
"lyrics": "[Intro]\nOh, hold on, hold on now\n\n[Verse]\nI was walking with a wire in my chest\nStatic in my shoes and a name I never guessed\nThen a doorway opened through the basement sound\nAnd every tired heartbeat started shaking the ground\n\n[Chorus]\nLift me higher than the old routine\nTurn these sparks into a silver stream\nIf I stumble, let the whole room sing\nCarry me, carry me in the swing\n\n[Bridge]\nHey now, hey now\nHands on the downbeat, soul in the snare\nHey now, hey now\nCall from the shadows, answer from the air\n\n[Outro]\nCarry me, carry me"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/042af0d9-292c-4531-a37b-8bbf5d849710.mp3"
}
}{
"taskType": "audioInference",
"taskUUID": "b924b635-7802-43f2-a48d-fe0e0ce2053b",
"audioUUID": "b6395f14-70c7-4029-b7d4-6c8fa6292139",
"audioURL": "https://am.runware.ai/audio/os/a09dlim3/ws/5/ai/b6395f14-70c7-4029-b7d4-6c8fa6292139.mp3",
"seed": 33183,
"cost": 0.15
}Dusty Motown Roller Rink
{
"taskType": "audioInference",
"taskUUID": "104ff53c-245d-4198-955d-3125846a4b1e",
"model": "minimax:music@cover",
"positivePrompt": "Transform this song into a retro Motown-inspired roller-rink soul cover with warm analog bass, crisp tambourine, lush string stabs, electric piano, rhythm guitar, rounded drums, joyful backing harmonies, and a smoky charismatic lead voice while preserving the original melody.",
"seed": 52318,
"settings": {
"lyrics": "[Intro]\n\n[Verse]\nKeep the original lyrics and phrasing from the source vocal.\n\n[Chorus]\nKeep the original lyrics and phrasing from the source vocal.\n\n[Verse]\nKeep the original lyrics and phrasing from the source vocal.\n\n[Chorus]\nKeep the original lyrics and phrasing from the source vocal.\n\n[Bridge]\nKeep the original lyrics and phrasing from the source vocal.\n\n[Chorus]\nKeep the original lyrics and phrasing from the source vocal.\n\n[Outro]"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/dca407c6-ce4c-4f2d-a9c2-3ea792378b48.mp3"
}
}{
"taskType": "audioInference",
"taskUUID": "104ff53c-245d-4198-955d-3125846a4b1e",
"audioUUID": "c4bfea87-c364-409f-964c-238a3c29a232",
"audioURL": "https://am.runware.ai/audio/os/a08dlim3/ws/5/ai/c4bfea87-c364-409f-964c-238a3c29a232.mp3",
"seed": 52318,
"cost": 0.15
}Midnight Mirage Synth Cabaret
{
"taskType": "audioInference",
"taskUUID": "645e49e9-cf55-453b-83b9-c2219b6c9ff9",
"model": "minimax:music@cover",
"positivePrompt": "Transform this song into a nocturnal synth cabaret piece with sultry contralto vocals, analog bass, brushed drums, cinematic piano, soft brass swells, and a glamorous late-1980s lounge atmosphere while preserving the lead melody.",
"seed": 76696,
"settings": {
"lyrics": "[Intro]\n[Verse]\n[Chorus]\n[Verse]\n[Chorus]\n[Bridge]\n[Chorus]\n[Outro]"
},
"inputs": {
"audio": "https://assets.runware.ai/assets/inputs/39b43dfa-e54f-456a-885f-a51316556d55.mp3"
}
}{
"taskType": "audioInference",
"taskUUID": "645e49e9-cf55-453b-83b9-c2219b6c9ff9",
"audioUUID": "87c43150-0b58-4f6f-b737-5b89b4220ed9",
"audioURL": "https://am.runware.ai/audio/os/a10dlim3/ws/5/ai/87c43150-0b58-4f6f-b737-5b89b4220ed9.mp3",
"seed": 76696,
"cost": 0.15
}