MiniMax

MiniMax Music 2.6

minimax-music-2.6

文本生成完整歌曲的人声加器乐模型，新增 AI Cover 风格改编与自动写词，首次输出延迟宣称 20 秒内

minimax-music-2.6

试用 minimax-music-2.6

输入

歌词

纯器乐

作品灵感

查看全部作品

输出

填写参数并生成，结果会显示在这里。

价格

minimax-music-2.6 每首

单价	$0.210

定位简介

minimax-music-2.6 是 MiniMax 的文本生成歌曲模型，通过 HiAPI.ai 统一接口调用。输入风格提示词即可生成含人声与多层器乐的完整歌曲，也可只写提示词让它自动作词，或切换到纯器乐模式输出无人声配乐。歌词支持结构标签控制段落编排，输出格式、码率与采样率可按需指定。适合需要批量产出原创配乐、歌曲 Demo 与风格改编素材的开发者与内容团队。

核心亮点

端到端产出完整歌曲——一次调用返回含人声、器乐与流派化混音的成品，而非片段素材，省去多轨拼接。
歌词可自动生成——提示词即可驱动模型写词并成曲，无作词能力时也能直接得到带人声的作品。
歌词结构标签控制编排——用 Intro、Verse、Chorus、Bridge 等标签划分段落，对歌曲走向做确定性安排。
输出规格可选——支持 mp3、wav、pcm 三种格式，码率与采样率在 schema 给定档位内自选，便于对接后续流程。

能力说明

文生歌曲：输入风格、情绪与场景描述，模型生成含人声与多层器乐的完整歌曲，可直接作为成品素材或 Demo 使用。

纯器乐生成：开启器乐模式后无需提供歌词，输出无人声的伴奏或器乐曲，适合背景音乐类需求。

自动作词：歌词字段留空时由模型依据提示词生成歌词，降低从零写词的门槛；需要精确控制时仍可自行提供歌词。

结构化编曲：歌词中可嵌入段落结构标签，控制前奏、主歌、副歌与间奏等安排，使输出结构更贴合预期。

输出参数可控：可指定音频格式、码率与采样率，按下游剪辑、分发或播放场景选择合适的输出规格。

适用场景

短视频与播客创作者生成配乐——以风格与情绪描述为输入，产出可直接铺在视频或播客中的背景音乐，减少外部曲库依赖。
词曲创作者验证歌曲 Demo——提交风格提示与试写歌词，快速得到含人声的完整 Demo，用于旋律与编曲方向的验证。
无作词能力时一站式成曲——用一句场景描述驱动自动写词并生成歌曲，产出可用于活动、广告或内容分发的原创曲目。
纯器乐伴奏批量产出——开启器乐模式，批量生成无人声伴奏，用于口播、展示或游戏等需要留出人声位的场景。

限制与选型建议

歌词字段上限 3500 字符、风格提示上限 2000 字符，超长内容需先精简。生成结果高度依赖提示词质量，自动生成的歌词建议人工复核后再使用。若需求是改编已有歌曲风格或对实时性要求极高的交互，当前参数能力未覆盖该用法，应另选支持相应输入形式的模型。

提交生成任务

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

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：minimax-music-2.6

routestring可选

当前固定值：default

inputobject必填

minimax-music-2.6 和线路 default 的业务参数对象，见下方参数表。

lyricsstring可选minLength 1maxLength 3500

歌曲歌词，1-3500 字符，用 \n 分隔行；支持 [Intro]、[Verse]、[Chorus] 等结构标签控制编曲段落。留空则根据 prompt 自动生成歌词；当 is_instrumental 为 true 时无需提供。

promptstring必填minLength 1maxLength 2000

音乐风格、情绪与场景的描述文本，例如「流行、忧郁、适合雨夜」，最长 2000 字符。

bitrateinteger可选默认值: 256000

输出音频比特率，单位 bps，默认 256000。

可选项：3200064000128000256000

sample_rateinteger可选默认值: 44100

输出音频采样率，单位 Hz，默认 44100。

可选项：16000240003200044100

audio_formatstring可选默认值: "mp3"

输出音频格式，默认 mp3。

可选项：mp3wavpcm

is_instrumentalboolean可选默认值: false

是否生成无人声的纯器乐音乐；为 true 时无需提供歌词，默认 false。

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-music-2.6",
  "input": {
    "prompt": "…",
    "bitrate": 256000,
    "sample_rate": 44100,
    "audio_format": "mp3",
    "is_instrumental": false
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-music-2.6",
    input: {
      "prompt": "…",
      "bitrate": 256000,
      "sample_rate": 44100,
      "audio_format": "mp3",
      "is_instrumental": false
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-music-2.6",
        "input": {
          "prompt": "…",
          "bitrate": 256000,
          "sample_rate": 44100,
          "audio_format": "mp3",
          "is_instrumental": False
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}