用途:该技能用于调用 MiniMax 音乐生成 API(默认 music-2.5)生成音乐,适合由歌词与风格提示词产出歌曲或器乐曲,或在流程中集成音乐生成。
主要能力:支持三种模式——标准歌曲(歌词+风格提示词)、纯音乐/无人声器乐、人声哼唱或吟唱(用音节代替完整歌词)。歌词为 API 必填字段,prompt 在 music-2.5 中可选;输出格式默认 hex(内联音频),也可选 url(下载链接,24 小时过期,需立即下载)。生成的音频可指定格式、比特率与采样率。
使用方式:先设置密钥 export MINIMAX_MUSIC_API_KEY="your_api_key",再运行脚本。例如:python scripts/generate_music.py --lyrics "[Verse]\n...\n[Chorus]\n..." --prompt "indie folk, melancholic, introspective" --output ./output.mp3。也可用结构化参数(--genre、--mood、--bpm、--instruments、--vocals、--use-case、--avoid、--references)自动拼接提示词;用 --output-format url --download 从链接下载。API 端点为 POST https://api.minimaxi.com/v1/music_generation,认证头 Authorization: Bearer <token>。
适用场景:按提示词生成歌曲、纯音乐背景音乐(如咖啡馆、雨夜、钢琴独奏等场景描述)、哼唱/吟唱治愈或冥想类音乐。
限制与注意:lyrics 为必填;纯音乐时长通常较短(约 1-2 分钟);url 输出 24 小时过期;提示词需结构化、避免冲突描述;更多接口细节见参考文档,价格与商用授权等资料暂未提供。