| name | music-generation |
| description | Use this skill when the user requests to generate, create, compose, or produce music or songs — background music, theme songs, jingles, or instrumental tracks. Generates a song from a style/mood prompt and optional lyrics via the MiniMax music API. |
Music Generation Skill
Overview
This skill generates songs (vocal or instrumental) from a structured JSON spec using the
MiniMax music generation API (/v1/music_generation). You describe the style/mood/scene in
prompt, optionally provide lyrics, and the script returns an MP3.
Workflow
Step 1: Understand Requirements
Identify the desired style, mood, scene, language, and whether the user wants vocals or a
pure instrumental track. Decide whether to supply lyrics or let the model write them.
Step 2: Create the Spec JSON
Write a JSON file in /mnt/user-data/workspace/ named {descriptive-name}.json:
{
"title": "Rainy Night Cafe",
"prompt": "indie folk, melancholic, introspective, walking alone, cafe",
"lyrics": "[verse]\nStreetlights glow the night wind sighs\n[chorus]\nPush the wooden door warm air inside"
}
Fields:
title (optional): a human-readable name.
prompt (required): style, mood, and scene. Drives the musical character.
lyrics (optional): song lyrics. Use \n between lines and structure tags such as
[Intro], [Verse], [Pre Chorus], [Chorus], [Bridge], [Outro].
is_instrumental (optional, bool): set true for a pure instrumental track (no lyrics needed).
Behavior:
lyrics provided → those lyrics are sung.
is_instrumental: true → instrumental, no vocals.
- neither → the model auto-writes lyrics from
prompt (lyrics_optimizer).
Step 3: Execute Generation
python /mnt/skills/public/music-generation/scripts/generate.py \
--prompt-file /mnt/user-data/workspace/rainy-night-cafe.json \
--output-file /mnt/user-data/outputs/rainy-night-cafe.mp3
Parameters:
--prompt-file: Absolute path to the JSON spec (required).
--output-file: Absolute path for the output MP3 (required).
[!NOTE]
Do NOT read the python file, just call it with the parameters.
Environment
MINIMAX_API_KEY (required): your MiniMax interface key.
MINIMAX_API_HOST (optional): default https://api.minimaxi.com.
MINIMAX_MUSIC_MODEL (optional): default music-2.6-free (works for all API-key users);
paid/Token-Plan users can set music-2.6 for higher limits.
Output Handling
- Music is saved as MP3 (typically in
/mnt/user-data/outputs/).
- Share the generated file with the user using the present_files tool.
- Offer to iterate on style or lyrics if adjustments are needed.
Notes
- Keep
prompt focused on style/mood/scene; put the actual sung words in lyrics.
- For non-English songs, write
lyrics in the target language.