MiniMax 格式(MiniMax Music)
通过 POST /v1/chat/completions 以 SSE 流式生成歌曲,可用模型 minimax-music-v2.6 / minimax-music-v3.0(独立定价,以模型广场为准)。生成期间每 15 秒推送一个心跳块保持连接,出歌后推送音频下载地址——无需提交任务和轮询,也不存在「生成超时被掐断、扣费拿不到结果」的问题。
调用流程
- 发起请求:
POST /v1/chat/completions,stream: true必须开启,业务参数放metadata对象; - 读取流:生成期间(约 40~341 秒,纯音乐较长)每 15 秒收到一个空内容心跳块;出歌后某个块的
delta.content即歌曲 mp3 地址; - 下载音频:访问该 URL 保存文件,地址 12 小时有效,请及时转存。
stream 必须为 true,且请求必须带 messages 数组。客户端超时建议 ≥600 秒。
请求参数
prompt / lyrics / is_instrumental 至少传一个,三种用法:
- 自定义歌词:
lyrics(必填)+prompt(可选风格描述) - 自动写词:
lyrics_optimizer: true+prompt(歌曲主题),不传lyrics - 纯音乐:
is_instrumental: true+prompt(必填),无需lyrics
调用示例
流式响应节选(心跳块已省略):
计费与错误
- 计费:流式末块
usage.prompt_tokens即本次用量(100000/首),按模型倍率计价,可在控制台「使用日志」核对。 - 失败:上游业务错误以
delta.content文本(生成失败(未计费): ...)快速送达并基本不计费,不会出现「扣了费拿不到结果」。 - 音频地址 12 小时有效,请及时下载转存。
附:Suno 任务格式(已停用)
Suno 任务格式已于 2026-09-21 停用:/suno/* 端点已下线,调用将返回 404。请改用上文「MiniMax Music(chat 流式)」或火山引擎格式的新版异步任务。以下内容仅作历史参考。
异步任务协议(Suno 格式):提交后立即返回任务 ID,客户端轮询任务状态直至出歌。适合需要在任务队列中批量提交、轮询管理的场景;当前可用模型 minimax-music-2.0(MiniMax Music 2.0,按首计费,以模型广场为准)。
调用流程
- 提交任务:
POST /suno/submit/music,返回任务 ID; - 轮询任务:
GET /suno/fetch/{task_id}(单个)或POST /suno/fetch(批量,body 传{"ids": [...]}),直至status变为SUCCESS/FAIL; - 下载音频:任务对象的
data[].audio_url即歌曲 mp3 地址(7 天有效,请及时转存)。
提交参数
gpt_description_prompt(灵感模式)与 prompt(自定义模式歌词)至少填一个;两者都填时按「歌词 + 风格」生成。
提交响应:{"code":"success","message":"","data":"<任务ID>"};失败返回 {"code":"fail","message":"错误原因"}。
任务对象
自定义模式(传歌词 + 风格)的提交 body 示例:
mv 必须显式传 minimax-music-2.0:该协议缺省模型名会被网关补成 Suno 默认值(chirp-v3-0),本站不支持该模型,会返回「不支持的模型」错误。
生成按首计费,与歌曲时长无关(实测自动写词约 3 分钟整歌与短歌词小样同价);生成耗时 1~5 分钟属正常,轮询间隔建议 10 秒、总等待预留 5 分钟以上。歌曲 mp3 地址 7 天有效,商用场景请及时转存到自己的存储。
