跳转到主要内容
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-1.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"
  }
}

Authorizations

​
Authorization
string
header
required

HTTP: Bearer Auth

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

Headers

​
Content-Type
enum<string>
default:application/json
required

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

Available options:
application/json

Body

application/json
​
model
enum<string>
required

使用的模型名称，music-1.5

Available options:
music-1.5
​
prompt
string
required

音乐的描述，用于指定风格、情绪和场景。例如“流行音乐, 难过, 适合在下雨的晚上”。长度限制为 [10, 300] 个字符

Required string length: 10 - 300
​
lyrics
string
required

歌曲的歌词。使用 分隔每行。你可以在歌词中加入 [Intro], [Verse], [Chorus], [Bridge], [Outro] 等结构标签来优化生成的音乐结构。长度限制为 [10, 3000] 个字符

Required string length: 10 - 3000
​
stream
boolean
default:false

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

​
output_format
enum<string>
default:hex

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

Available options:
url,
hex
​
audio_setting
object

音频输出配置

​
aigc_watermark
boolean

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

Response

200 - application/json
​
data
object
​
base_resp
object

状态码及详情

⌘I