跳转到主要内容
POST
/
eleven
/
music
音乐生成
curl --request POST \
  --url https://api.mountsea.ai/eleven/music \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "musicLengthMs": 180000,
  "model": "music_v1",
  "detailed": false,
  "prompt": "A melancholic indie folk song with acoustic guitar and soft vocals",
  "compositionPlan": {
    "positive_global_styles": [
      "epic orchestral",
      "cinematic"
    ],
    "negative_global_styles": [
      "lo-fi",
      "acoustic"
    ],
    "sections": [
      {
        "section_name": "Verse",
        "positive_local_styles": [
          "soft piano",
          "building tension"
        ],
        "negative_local_styles": [
          "heavy drums"
        ],
        "duration_ms": 15000,
        "lines": [
          "First line of lyrics",
          "Second line"
        ]
      }
    ]
  },
  "seed": 877369,
  "forceInstrumental": false,
  "respectSectionsDurations": true,
  "outputFormat": "mp3_44100_128",
  "storeForInpainting": false,
  "signWithC2pa": false
}
'
{
  "taskId": "<string>"
}
使用 ElevenLabs music_v1 模型生成音乐。支持两种互斥的输入模式:
  • 提示模式:提供简单文本 prompt — 快速便捷
  • 作曲计划模式:提供结构化的 compositionPlan,按段落精细控制风格、时长和歌词
这是一个异步任务。响应中包含 taskId — 使用获取任务状态轮询生成的音频。

模式说明

简单提示

设置 prompt 描述所需音乐。可选设置 forceInstrumental: true 生成纯器乐。

作曲计划

设置 compositionPlan,包含 positive_global_stylesnegative_global_stylessections 数组。每个段落可有独立的 section_namepositive_local_stylesnegative_local_stylesduration_mslines(歌词)。
先使用创建作曲计划从文本提示生成计划(免费,不消耗积分),查看后再传入此处。

详细模式

设置 detailed: true 可在结果中获取歌词时间戳等元数据,对应 ElevenLabs 的 /v1/music/detailed 端点。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
musicLengthMs
number
必填

歌曲长度(毫秒),范围 3000-600000ms

必填范围: 3000 <= x <= 600000
示例:

180000

model
enum<string>
必填

模型 ID

可用选项:
music_v1
示例:

"music_v1"

detailed
boolean
默认值:false

是否返回详细信息(歌词时间戳等元数据),默认 false

prompt
string

简单文字提示(与 compositionPlan 互斥)

示例:

"A melancholic indie folk song with acoustic guitar and soft vocals"

compositionPlan
object

详细作曲计划(与 prompt 互斥,通过 /eleven/plan 生成)

seed
number

随机种子

示例:

877369

forceInstrumental
boolean
默认值:false

强制纯器乐,仅 prompt 模式

respectSectionsDurations
boolean
默认值:true

是否严格遵守段落时长,仅 compositionPlan 模式

outputFormat
enum<string>
默认值:mp3_44100_128

输出格式,格式为 codec_sampleRate_bitrate。MP3 192kbps 需要 Creator 及以上,PCM 44.1kHz 需要 Pro 及以上

可用选项:
mp3_22050_32,
mp3_24000_48,
mp3_44100_32,
mp3_44100_64,
mp3_44100_96,
mp3_44100_128,
mp3_44100_192,
pcm_8000,
pcm_16000,
pcm_22050,
pcm_24000,
pcm_32000,
pcm_44100,
pcm_48000,
ulaw_8000,
alaw_8000,
opus_48000_32,
opus_48000_64,
opus_48000_96,
opus_48000_128,
opus_48000_192
storeForInpainting
boolean
默认值:false

是否保存生成结果用于后续 Inpainting 编辑。仅限具备 Inpainting 权限的企业客户使用

signWithC2pa
boolean
默认值:false

是否使用 C2PA 签名标记 AI 生成内容。仅适用于 MP3 输出格式,会在文件中嵌入加密的 AI 生成来源证明

响应

200 - application/json

任务创建成功

taskId
string
必填

任务 ID,用于后续查询结果