跳转到主要内容
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
​
lyrics
string
必填

歌曲的歌词。使用 \n 分隔每行。你可以在歌词中加入 [Intro], [Verse], [Pre Chorus], [Chorus], [Interlude], [Bridge], [Outro], [Post Chorus], [Transition], [Break], [Hook], [Build Up], [Inst], [Solo] 等结构标签来优化生成的音乐结构。
长度限制：对于 music-2.5：[1, 3500] 个字符。对于非 music-2.5 模型：[10, 3500] 个字符

Required string length: 1 - 3500
​
prompt
string

音乐的描述，用于指定风格、情绪和场景。例如“流行音乐, 难过, 适合在下雨的晚上”。
注意：对于 music-2.5：可选，长度限制为 [0, 2000] 个字符。对于非 music-2.5 模型：必填，长度限制为 [10, 2000] 个字符

Maximum string length: 2000
​
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) 请求时生效

响应

200 - application/json
​
data
object
​
base_resp
object

状态码及详情