跳到主要内容
AI
MarkdownLLMs.txt

音乐生成

本文档介绍如何在 aijisu 中使用 MiniMax Music 2.6 异步音乐生成接口。

当前支持模型：

模型名称类型适合场景计费方式
minimax-music-2.6音乐生成广告音乐、短视频 BGM、播客开场、产品宣传曲、纯音乐氛围铺底按输出音频条数计费

接口采用异步任务模式：

操作方法路径
提交音乐任务POST/v1/audio/tasks
查询音乐任务GET/v1/audio/tasks/{task_id}

1. 通用鉴权​

所有接口都需要在请求头中携带 API Key：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx
Content-Type: application/json

示例域名：

https://api.xxx.xx

2. 模型简介​

minimax-music-2.6 用于根据音乐描述和歌词生成音乐音频。它适合生成短视频配乐、广告歌曲、品牌宣传曲、播客片头、课程开场音乐、情绪氛围 BGM 等。

模型支持两类常见方式：

  • 有歌词歌曲：传 prompt + lyrics
  • 纯音乐：传 prompt + is_instrumental: true

3. 提交音乐任务​

POST https://api.xxx.xx/v1/audio/tasks

3.1 请求参数​

参数类型必填说明
modelstring是固定为 minimax-music-2.6
promptstring是音乐描述，建议包含风格、情绪、速度、用途、乐器、声音质感
lyricsstring否歌词。非纯音乐时建议提供
lyrics_optimizerboolean否是否优化歌词
is_instrumentalboolean否是否生成纯音乐
audio_settingobject否音频设置对象，按平台开放能力透传

3.2 提交响应示例​

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "audio.generation.job",
  "status": "queued"
}

字段说明：

字段说明
id / task_id异步任务 ID，用于查询结果
status任务状态，常见值为 queued、processing、completed、failed

4. 查询音乐任务​

GET https://api.xxx.xx/v1/audio/tasks/{task_id}

查询示例：

curl -X GET "https://api.xxx.xx/v1/audio/tasks/task_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx"

完成响应示例：

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "audio.generation.job",
  "status": "completed",
  "audio_url": "https://api.xxx.xx/media/xxxxx.mp3",
  "result": {
    "outputs": [
      "https://api.xxx.xx/media/xxxxx.mp3"
    ],
    "audios": [
      {
        "url": "https://api.xxx.xx/media/xxxxx.mp3"
      }
    ]
  }
}

5. 请求示例​

5.1 生成广告歌曲​

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-music-2.6",
    "prompt": "A bright synth pop song for a product launch, upbeat, modern commercial style, clean vocal, energetic chorus",
    "lyrics": "Hello future, we are ready now\nLight the skyline, make it loud\nEvery step is shining brighter\nWe are here and moving proud",
    "lyrics_optimizer": true,
    "is_instrumental": false
  }'

5.2 生成短视频 BGM​

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-music-2.6",
    "prompt": "A catchy 30-second lifestyle vlog background track, light guitar, soft beat, sunny mood, no vocal",
    "is_instrumental": true
  }'

5.3 生成播客片头音乐​

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-music-2.6",
    "prompt": "A warm podcast intro jingle, 8 to 12 seconds feeling, soft piano, subtle electronic pulse, professional and friendly",
    "is_instrumental": true
  }'

5.4 生成中文品牌歌曲​

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-music-2.6",
    "prompt": "Chinese mandopop brand song, warm female vocal, inspiring chorus, clean arrangement, suitable for a technology brand",
    "lyrics": "向前走 不回头\n新的光 落在心口\n每一次 出发的时候\n我们都 把未来握在手中",
    "lyrics_optimizer": true,
    "is_instrumental": false
  }'

5.5 生成课程开场音乐​

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-music-2.6",
    "prompt": "Educational course intro music, calm but motivating, soft marimba, piano, gentle percussion, suitable for online learning",
    "is_instrumental": true
  }'

6. 常见错误​

6.1 缺少 prompt​

错误请求：

{
  "model": "minimax-music-2.6",
  "lyrics": "Hello world"
}

修复方式：补充 prompt。

6.2 非纯音乐但缺少歌词​

如果设置：

{
  "is_instrumental": false
}

建议同时传入 lyrics。

7. 推荐工作流​

  1. 根据场景写清楚音乐风格、情绪、用途。
  2. 如果需要人声，提供歌词。
  3. 提交 /v1/audio/tasks。
  4. 轮询 /v1/audio/tasks/{task_id}。
  5. 任务完成后读取 audio_url。

8. 最小可用请求​

curl -X POST "https://api.xxx.xx/v1/audio/tasks" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-music-2.6",
    "prompt": "A bright short commercial pop song, modern and uplifting",
    "is_instrumental": true
  }'