MiniMax AI 音乐生成

快速开始

前置条件

• MiniMax API Key（Token Plan 用户可用 sk-cp-F-... Key）
• Python 3.x + requests 库
• ffmpeg（用于合并曲目）

基础调用流程

1. 歌词生成（如需要）→ /v1/lyrics_generation
2. 歌曲生成 → /v1/music_generation
3. 下载音频文件
4. ffmpeg 合并多首（如需要）

歌词生成

接口: POST https://api.minimaxi.com/v1/lyrics_generation

payload = {
    "mode": "write_full_song",      # 写完整歌曲
    "prompt": "主题描述",
    "title": "歌名（可选）"
}

响应:

{
    "song_title": "歌名",
    "style_tags": "风格标签",
    "lyrics": "带结构的歌词（含 [Verse][Chorus] 等标签）",
    "base_resp": {"status_code": 0, "status_msg": "success"}
}

歌曲生成

接口: POST https://api.minimaxi.com/v1/music_generation

纯音乐（无人声）

payload = {
    "model": "music-2.6",
    "prompt": "风格描述",
    "is_instrumental": True,
    "output_format": "url"     # 返回下载URL
}

有歌词歌曲

payload = {
    "model": "music-2.6",
    "prompt": "风格描述（与歌词配合）",
    "lyrics": lyrics_text,       # 歌词（带 [Verse][Chorus] 等标签）
    "output_format": "url"
}

关键参数

生成时间：通常2-5分钟，timeout建议设为 600秒

响应:

{
    "data": {
        "audio": "https://...mp3",   # 下载URL（output_format=url时）
        "status": 2                  # 1=生成中，2=已完成
    },
    "extra_info": {
        "music_duration": 157335,   # 时长（毫秒）
        "music_sample_rate": 44100,
        "bitrate": 256000,
        "music_size": 5036711       # 文件大小（字节）
    },
    "base_resp": {"status_code": 0, "status_msg": "success"}
}

批量生成脚本

使用 scripts/generate.py，支持：

• 单曲生成
• 批量生成多首
• 歌词生成 + 歌曲合成
• 多首合并成一首

# 查看用法
python scripts/generate.py --help

# 生成纯音乐
python scripts/generate.py --prompt "欢快的流行音乐" --name "01_欢快流行" --save "D:\music_samples"

# 生成带歌词的歌曲（先歌词后歌曲）
python scripts/generate.py --lyrics-prompt "给唐晓加油打气的励志歌曲" --song-title "赠唐晓" --prompt "古风音乐" --name "赠唐晓_古风" --save "D:\music_samples"

# 合并已有文件（先生成多个文件后合并）
python scripts/generate.py --merge "D:\music_samples\01.mp3" "D:\music_samples\02.mp3" --output "D:\music_samples\merged.mp3"

FFmpeg 手动合并：

# 创建文件列表
# concat_list.txt 内容（每行 file '路径'）：
file 'D:\music_samples\曲1.mp3'
file 'D:\music_samples\曲2.mp3'
file 'D:\music_samples\曲3.mp3'

# 合并
ffmpeg -y -f concat -safe 0 -i "D:\music_samples\concat_list.txt" -c copy "D:\music_samples\合并版.mp3"

完整工作流示例

生成古风励志歌曲《赠唐晓》

import requests
import json

API_KEY = "your_key_here"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}