跳转到主要内容
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.5+",
  "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.5+（推荐）或 music-2.5

可用选项:
music-2.5+,
music-2.5
​
prompt
string

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

  • music-2.5+ 纯音乐（is_instrumental: true）：必填，长度限制 [1, 2000] 个字符
  • music-2.5 / music-2.5+（非纯音乐）：可选，长度限制 [0, 2000] 个字符
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.5+ 纯音乐（is_instrumental: true）：非必填
  • music-2.5 / music-2.5+（非纯音乐）：必填，长度限制 [1, 3500] 个字符
  • 当 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.5 和 music-2.5+ 支持。

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

​
is_instrumental
boolean
默认值:false

是否生成纯音乐（无人声）。仅 music-2.5+ 支持。

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

响应

200 - application/json
​
data
object
​
base_resp
object

状态码及详情