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

MiniMax Music 3 API

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

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

MiniMax Music 3:文本+歌词生成高保真完整歌曲,人声自然、编曲丰富;支持 1-300 秒时长控制与种子复现,输出无损 WAV,按生成时长计费。

生产建议

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

适用场景

完整歌曲生成

prompt 定风格、lyrics 自填歌词配结构标签,一次产出人声+编曲的完整作品。

promptlyrics
时长自由控制

duration 1-300 秒按需设定,从短样片、BGM 片段到完整单曲都能覆盖。

duration
结果可复现

固定 seed 复现同一次生成,方便逐项调整 prompt 对比效果。

seedprompt
高保真音质

输出 44.1kHz 立体声 WAV 无损音频,可直接进入后期制作流程。

请求参数

model string 必填

固定填 minimax-music-3。

示例 minimax-music-3
input object 必填

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

prompt string 必填

音乐风格、情绪、人声与编曲描述。想精确控制可写明流派、BPM、调性、情绪推进、人声细节和分段编曲。

lyrics string 必填

歌词,每行一句(用 \n 分隔)。结构标签 [intro]、[verse]、[pre-chorus]、[chorus]、[post-chorus]、[bridge]、[instrumental]、[solo]、[outro] 必须独占一行;与标签写在同一行的文字会被丢弃。纯音乐可只填 [instrumental] 标签。

duration number 可选

生成时长上限(秒),1-300。模型可能提前结束,实际音频不超过该值;计费按请求的秒数。

默认 60
seed integer 可选

随机种子。传入相同 seed 可复现同一次生成;不传则每次随机。

callback object 可选

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

url string 必填

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

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

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

默认 final 可选值: final

用例示例

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

线上实测:自填中文歌词 + 结构标签,30 秒女声城市流行。

请求体
{
  "model": "minimax-music-3",
  "input": {
    "prompt": "Mandarin city-pop with funky bass, bright brass stabs and shimmering synth pads; 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]",
    "duration": 30
  }
}
史诗序章(纯音乐)

歌词只填 [instrumental] 标签即得无人声纯音乐,时长 90 秒。

请求体
{
  "model": "minimax-music-3",
  "input": {
    "prompt": "Epic cinematic orchestral theme with soaring strings, powerful brass, thunderous percussion and a heroic adventurous mood, film-score quality",
    "lyrics": "[instrumental]",
    "duration": 90
  }
}
固定种子复现

传入 seed 固定随机性,相同参数可复现同一结果,便于对比调参。

请求体
{
  "model": "minimax-music-3",
  "input": {
    "prompt": "Mandarin city-pop with funky bass, bright brass stabs and shimmering synth pads; 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]",
    "duration": 30,
    "seed": 42
  }
}

获取结果

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

常见问题

和 MiniMax Music 2.6 有什么区别?

Music 3 歌词必填,支持 duration(1-300 秒)控制时长上限和 seed 复现结果,输出无损 WAV,按生成时长计费;Music 2.6 歌词可留空自动写词、有 is_instrumental 纯音乐开关,按首计费。

想要纯音乐怎么办?

lyrics 只填 [instrumental] 结构标签,并在 prompt 里写清曲风与配器,即可生成无人声版本。

怎么计费?

按请求的 duration 秒数计费;模型可能提前结束,计费以请求时长为准。实时价格以价格页为准。

输出什么格式、怎么获取?

输出 44.1kHz 立体声 WAV。任务 status=success 后,从返回的 output[].url 下载音频文件。

下一步