跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

MiniMax Music 2.6 API

POST /v1/tasks

所有模型都通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 minimax-music-2.6
类型 音频生成（text-to-music）
接口 POST /v1/tasks
价格 见 HiAPI 定价

MiniMax Music 2.6:文本生成完整歌曲,人声自然、编曲丰富;歌词上限 3500 字符,支持纯音乐模式与自动写词,中英文皆可演唱,按首计费。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

完整歌曲生成

prompt 定风格、歌词自填或自动生成,一次产出人声+编曲完整成品曲,不是纯 BGM 片段。

promptlyrics
纯音乐 / BGM

is_instrumental 一键切换纯音乐模式,适合影视配乐、播客与游戏 BGM。

is_instrumentalprompt
精细结构控制

支持 [Pre Chorus][Hook][Build Up][Solo] 等 14 种结构标签,歌词上限 3500 字符,长歌编排层次分明。

lyrics
自动写词

只给风格描述、歌词留空即自动从 prompt 生成完整歌词,快速出 demo。

prompt

请求参数

model string 必填

固定填 minimax-music-2.6。

示例 minimax-music-2.6
input object 必填

业务参数对象；MiniMax Music 2.6 的模型专属配置都放在这里。

prompt string 必填

音乐风格、情绪与场景描述,例如"流行、忧郁、适合雨夜"。最长 2000 字符。

lyrics string 可选

歌词,每行一句(用 \n 分隔),1-3500 字符。可用结构标签控制编排:常用 [Intro](前奏)、[Verse](主歌)、[Chorus](副歌)、[Bridge](桥段)、[Outro](尾奏),另有 Pre Chorus/Interlude/Hook/Solo 等共 14 种。留空时自动根据 prompt 写词;is_instrumental 为 true 时无需填写。

is_instrumental boolean 可选

生成无人声的纯音乐。为 true 时无需提供歌词。

默认 false
sample_rate enum 可选

音频采样率(Hz)。

默认 44100 可选值: 16000240003200044100
bitrate enum 可选

音频码率(bps)。

默认 256000 可选值: 3200064000128000256000
audio_format enum 可选

输出音频格式。

默认 mp3 可选值: mp3wavpcm
callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

霓虹夜驶(中文城市流行)

自填中文歌词 + 结构标签实测:城市流行、女声。

请求体
{
  "model": "minimax-music-2.6",
  "input": {
    "prompt": "Uplifting Mandarin city-pop with funky bass, bright brass stabs, shimmering synth pads and a confident female lead vocal; polished retro-modern production, driving groove for a neon night drive",
    "lyrics": "[Intro]\n[Verse]\n霓虹在后视镜里流成河\n城市的心跳踩着油门\n[Chorus]\n就让今晚的灯光都为我闪烁\n一路向前不回头\n[Outro]",
    "is_instrumental": false,
    "sample_rate": 44100,
    "bitrate": 256000,
    "audio_format": "mp3"
  }
}
史诗序章(纯音乐)

is_instrumental 纯音乐模式实测:电影配乐质感。

请求体
{
  "model": "minimax-music-2.6",
  "input": {
    "prompt": "Epic cinematic orchestral theme with soaring strings, powerful brass, thunderous percussion and a heroic adventurous mood, film-score quality",
    "is_instrumental": true
  }
}
体育场合唱(自动写词)

歌词留空自动写词实测:只传 prompt 即可成歌。

请求体
{
  "model": "minimax-music-2.6",
  "input": {
    "prompt": "Energetic Mandarin pop-rock anthem with driving electric guitars, punchy drums and a passionate female vocal, stadium-size chorus, triumphant mood"
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载生成的音频。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

和 MiniMax Music 1.5 有什么区别?

歌词上限从 600 提升到 3500 字符;新增纯音乐模式(is_instrumental)与自动写词;结构标签从 5 种扩展到 14 种。

可以不写歌词吗?

可以。歌词留空时模型会根据 prompt 自动写词;需要无人声版本时把 is_instrumental 设为 true。

怎么计费?

按首计费,价格与歌曲时长无关,实时价格以价格页为准。

支持哪些语言演唱?

中文和英文歌词都能自然演唱,也可以在 prompt 中描述曲风让模型自动匹配语言。

下一步