| name | minimax-music |
| description | 使用 MiniMax 音乐生成 API(music-2.5 / music-2.5+)创作歌曲、纯音乐和自动歌词作品。用户提到“生成音乐/写歌/BGM/纯音乐/哼唱/歌词自动生成/MiniMax 音乐”时都应使用本 skill,即使用户只说“做一首歌”也应触发。 |
MiniMax 音乐生成 Skill
用 MiniMax Music API 快速完成三类任务:
- 有歌词歌曲(Standard Song)
- 纯音乐(Instrumental)
- 自动写歌词并生成(Auto Lyrics)
环境变量
MINIMAX_MUSIC_API_KEY="你的 MiniMax Key"
兼容:
- 若未配置
MINIMAX_MUSIC_API_KEY,可回退使用 MINIMAX_API_KEY
- 可选:
MINIMAX_API_HOST(默认 https://api.minimaxi.com)
接口与模型
- Endpoint:
POST https://api.minimaxi.com/v1/music_generation
- 推荐模型:
music-2.5+
- 兼容模型:
music-2.5
详细参数参考:references/minimax_music_api.md
风格清单(完整版,含“搞笑可玩”置顶推荐):references/music_style_catalog_zh.md
工作流程
Step 1: 判断模式
- Standard Song(默认)
用户提供歌词,或明确要“有人声演唱歌曲”。
- Instrumental
用户说“纯音乐/BGM/无人声/instrumental”。
- Auto Lyrics
用户希望“你先写歌词再生成”或“自动歌词”。
Step 2: 组织 Prompt 与歌词
Prompt 采用结构化字段,优先覆盖:
- Genre(风格)
- Mood(情绪)
- BPM / Tempo(节奏)
- Instruments(主乐器)
- Vocals(人声特点)
- Use Case(使用场景)
- Avoid(不希望出现的元素)
如果用户没给清晰风格,优先到 references/music_style_catalog_zh.md 里选一组“首推搞笑可玩”风格模板,再做轻微改写。
建议模板:
Genre: ...
Mood: ...
Tempo: ... BPM
Instruments: ...
Vocals: ...
Use case: ...
Avoid: ...
References: ...
歌词建议使用段落标签:
[Intro]
[Verse]
[Pre Chorus]
[Chorus]
[Bridge]
[Outro]
Step 3: 生成
Standard Song(有歌词)
curl -sS -X POST "https://api.minimaxi.com/v1/music_generation" \
-H "Authorization: Bearer $MINIMAX_MUSIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "music-2.5+",
"prompt": "Genre: pop, Mood: warm and uplifting, Tempo: 92 BPM, Instruments: piano + strings, Vocals: gentle female",
"lyrics": "[Verse]\n...\n[Chorus]\n...",
"output_format": "url",
"audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}
}'
Instrumental(纯音乐)
curl -sS -X POST "https://api.minimaxi.com/v1/music_generation" \
-H "Authorization: Bearer $MINIMAX_MUSIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "music-2.5+",
"prompt": "coffee shop lofi, relaxing, no vocals",
"is_instrumental": true,
"output_format": "url"
}'
Auto Lyrics(自动歌词)
curl -sS -X POST "https://api.minimaxi.com/v1/music_generation" \
-H "Authorization: Bearer $MINIMAX_MUSIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "music-2.5+",
"prompt": "summer road trip, upbeat pop, male vocal",
"lyrics_optimizer": true,
"output_format": "url"
}'
Step 4: 保存与返回
- 若
output_format=url:下载 URL 到本地文件(URL 通常有时效)。
- 若
output_format=hex:按十六进制解码保存音频。
- 输出给用户:文件路径、时长(如接口返回)、主要参数。
质量与安全约束
- 不要承诺“精确复刻真人歌手声音”。
- 可使用“风格参考”描述,但避免宣称是官方授权克隆。
- 出现 API 失败时,先重试一次;若仍失败,返回错误摘要与排查建议。
输出格式(给用户)
始终用以下格式回复结果:
模式: <song|instrumental|auto-lyrics>
模型: <model>
提示词: <prompt 摘要>
输出文件: <path>
状态: <成功/失败>