MiniMax Music Generation#

Generate music using MiniMax music-2.6 (text-to-music) or music-cover (cover/lyrics-swap) model and send as Feishu MP3 attachment.

Two Generation Modes#

1. Text-to-Music ( music-2.6) — 从零生成#

根据 prompt + lyrics 全新生成歌曲。

2. Cover ( music-cover) — 保留旋律换歌词#

上传参考音频，保留原曲旋律和结构，只换歌词内容。适合：修正歌词、保留原版风格。

Setup#

Configure music_config.json#

Create ~/.openclaw/workspace/skills/minimax-feishu-music/music_config.json:

json

{
  "api_key": "YOUR_MINIMAX_API_KEY"
}

Lyrics Structure Tags#

lyrics 使用 \n 分隔每行，支持以下结构标签：

标签含义作用[Intro]前奏歌曲开头，引出主题[Verse]主歌叙事部分，讲述故事[Pre Chorus]预副歌主歌到副歌的过渡[Chorus]副歌高潮部分，旋律最突出[Interlude]间奏歌曲中间的纯音乐过渡[Bridge]桥段打破重复，增加层次[Outro]尾奏歌曲结尾渐弱结束[Post Chorus]后副歌主歌后的副歌变体[Transition]转接段落间的过渡[Break]停顿突然的静默，制造戏剧效果[Hook]记忆点最抓耳的旋律/歌词[Build Up]渐强逐渐积累能量推向高潮[Inst]纯音乐instrumental，无人声[Solo]独奏乐器solo段落

Song Structure#

歌曲结构由歌词内容和情感节奏决定，不按固定类型选择。根据以下判断：

• 叙事性强的歌词（讲故事）→ 多用 [Verse] + [Chorus]
• 情绪递进强烈 → 加入 [Pre Chorus] [Build Up] [Break]
• 有器乐展示需求 → 加入 [Interlude] [Solo]
• 情感冲击大 → 加入 [Hook] [Bridge] [Post Chorus]
• 自然结束 → 结尾用 [Outro]；突然打断 → [Break]

用户说"完整版"时，默认使用包含全部标签的完整结构，但可根据歌词内容适当增删标签，以最适合歌曲为准。

Quick Use#

从零生成（music-2.6）#

bash

python3 ~/.openclaw/workspace/skills/minimax-feishu-music/skill-scripts/send_feishu_music.py \
  --prompt "<音乐风格描述>" \
  --lyrics "<歌词内容>" \
  --title "<文件名.mp3>" \
  <飞书用户的open_id>

翻唱模式（music-cover）— 保留旋律换歌词#

bash

python3 ~/.openclaw/workspace/skills/minimax-feishu-music/skill-scripts/send_feishu_music.py \
  --cover "<参考音频文件路径>" \
  --prompt "<目标音乐风格描述>" \
  --lyrics "<新歌词内容>" \
  --title "<文件名.mp3>" \
  <飞书用户的open_id>

翻唱示例：

bash

python3 ~/.openclaw/workspace/skills/minimax-feishu-music/skill-scripts/send_feishu_music.py \
  --cover "/Users/ray/.openclaw/workspace/songs/original_song.mp3" \
  --prompt "轻柔抒情流行，温柔女声，慢节奏" \
  --lyrics "[Intro]
(Ooh-ooh)
(Yeah)
[Verse]
黄昏的咖啡店门口
风铃轻轻摇晃
你从远处走来
Smiling face, so beautiful
[Pre Chorus]
心跳突然加速
想说的话在嘴边
[Chorus]
风吹过街角
带走了沉默
你是我最想留住的温度
Be with you, always
[Outro]
就这样一直唱下去
唱到我们都老去" \
  --title "cover_song.mp3" \
  "<open_id>"

API Parameters#

参数说明model``music-2.6 或 music-cover``prompt音乐风格描述（cover 模式必填，10-300字符）lyrics歌词，必须包含 \n 分隔，标签首字母大写--cover参考音频文件路径（仅 cover 模式，脚本自动处理 base64）audio_setting.format固定为 mp3``audio_setting.sample_rate44100audio_setting.bitrate256000