| 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>
状态: <成功/失败>
