跳转到主要内容
POST
/
v1
/
music_generation
Music Generation
curl --request POST \
  --url https://api.minimaxi.com/v1/music_generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model": "music-2.6",
  "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆",
  "lyrics": "[verse]\n街灯微亮晚风轻抚\n影子拉长独自漫步\n旧外套裹着深深忧郁\n不知去向渴望何处\n[chorus]\n推开木门香气弥漫\n熟悉的角落陌生人看",
  "audio_setting": {
    "sample_rate": 44100,
    "bitrate": 256000,
    "format": "mp3"
  }
}
'
{
  "data": {
    "audio": "hex编码的音频数据",
    "status": 2
  },
  "trace_id": "04ede0ab069fb1ba8be5156a24b1e081",
  "extra_info": {
    "music_duration": 25364,
    "music_sample_rate": 44100,
    "music_channel": 2,
    "bitrate": 256000,
    "music_size": 813651
  },
  "analysis_info": null,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

授权

​
Authorization
string
header
必填

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在 账户管理>接口密钥 中查看。

请求头

​
Content-Type
enum<string>
默认值:application/json
必填

请求体的媒介类型，请设置为 application/json，确保请求数据的格式为 JSON

可用选项:
application/json

请求体

application/json
​
model
enum<string>
必填

使用的模型名称。可选值：

  • music-2.6（推荐）：文本生成音乐，仅限 Token Plan 用户和付费用户使用，RPM 较高
  • music-cover：基于参考音频生成翻唱版本，仅限 Token Plan 用户和付费用户使用，RPM 较高
  • music-2.6-free：music-2.6 的限免版本，所有用户可通过 API Key 使用，RPM 较低
  • music-cover-free：music-cover 的限免版本，所有用户可通过 API Key 使用，RPM 较低
可用选项:
music-2.6,
music-cover,
music-2.6-free,
music-cover-free
​
prompt
string

音乐的描述，用于指定风格、情绪和场景。例如"流行音乐, 难过, 适合在下雨的晚上"。
注意：

  • music-2.6 / music-2.6-free 纯音乐（is_instrumental: true）：必填，长度限制 [1, 2000] 个字符
  • music-2.6 / music-2.6-free（非纯音乐）：可选，长度限制 [0, 2000] 个字符
  • music-cover / music-cover-free：必填，描述目标翻唱风格，长度限制 [10, 300] 个字符
Maximum string length: 2000
​
lyrics
string

歌曲歌词，使用 \n 分隔每行。支持结构标签：[Intro], [Verse], [Pre Chorus], [Chorus], [Interlude], [Bridge], [Outro], [Post Chorus], [Transition], [Break], [Hook], [Build Up], [Inst], [Solo]。
注意：

  • music-2.6 / music-2.6-free 纯音乐（is_instrumental: true）：非必填
  • music-2.6 / music-2.6-free（非纯音乐）：必填，长度限制 [1, 3500] 个字符
  • music-cover / music-cover-free：可选，如不传则通过 ASR 自动从参考音频中提取歌词，长度限制 [10, 1000] 个字符
  • 当 lyrics_optimizer: true 且 lyrics 为空时，系统将根据 prompt 自动生成歌词
Required string length: 1 - 3500
​
stream
boolean
默认值:false

是否使用流式传输，默认为 false

​
output_format
enum<string>
默认值:hex

音频的返回格式，可选值为 url 或 hex，默认为 hex。当 stream 为 true 时，仅支持 hex 格式。注意：url 的有效期为 24 小时，请及时下载

可用选项:
url,
hex
​
audio_setting
object

音频输出配置

​
aigc_watermark
boolean

是否在音频末尾添加水印，默认为 false。仅在非流式 (stream: false) 请求时生效

​
lyrics_optimizer
boolean
默认值:false

是否根据 prompt 描述自动生成歌词。仅 music-2.6 / music-2.6-free 支持。

设为 true 且 lyrics 为空时，系统会根据 prompt 自动生成歌词。默认为 false

​
is_instrumental
boolean
默认值:false

是否生成纯音乐（无人声）。仅 music-2.6 / music-2.6-free 支持。

设为 true 时，lyrics 字段非必填。默认为 false

​
audio_url
string

参考音频的 URL 地址。仅用于 music-cover / music-cover-free 模型。audio_url 和 audio_base64 必须且只能提供其中一个。与 cover_feature_id 互斥。

参考音频要求：

  • 时长：6 秒至 6 分钟
  • 大小：最大 50 MB
  • 格式：支持常见音频格式（mp3、wav、flac 等）
​
audio_base64
string

Base64 编码的参考音频。仅用于 music-cover / music-cover-free 模型。audio_url 和 audio_base64 必须且只能提供其中一个。与 cover_feature_id 互斥。

参考音频要求：

  • 时长：6 秒至 6 分钟
  • 大小：最大 50 MB
  • 格式：支持常见音频格式（mp3、wav、flac 等）
​
cover_feature_id
string

翻唱前处理 接口返回的特征 ID，用于两步翻唱流程，支持修改歌词后生成翻唱。

仅用于 music-cover / music-cover-free 模型。与 audio_url 和 audio_base64 互斥。

  • 传入时 lyrics 为必填（长度限制 [10, 1000] 个字符）
  • cover_feature_id 有效期为 24 小时
  • 相同音频内容返回相同的 cover_feature_id

响应

200 - application/json
​
data
object
​
base_resp
object

状态码及详情