Skip to main content
POST
音乐生成
使用 ElevenLabs 音乐模型(music_v1 / music_v2)生成音乐。对应官方 POST /v1/music/detailed — 结果包含歌词时间戳、作曲计划等元数据。 支持两种互斥的输入模式:
  • 提示模式:提供简单文本 prompt — 快速便捷
  • 作曲计划模式:提供结构化的 compositionPlan,按段落精细控制风格、时长和歌词
这是一个异步任务。响应中包含 taskId — 使用获取任务状态轮询生成的音频。

模式说明

简单提示

设置 prompt 描述所需音乐。可选设置 forceInstrumental: true 生成纯器乐。此模式建议填写 musicLengthMs

作曲计划

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

常用选项

授权

Authorization
string
header
必填

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

请求体

application/json
model
enum<string>
必填

模型 ID

可用选项:
music_v1,
music_v2,
eleven_multilingual_v2,
eleven_turbo_v2_5,
eleven_flash_v2_5,
eleven_v3
示例:

"music_v1"

prompt
string

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

示例:

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

compositionPlan
object

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

musicLengthMs
number

歌曲长度(毫秒),范围 3000-600000ms。prompt 模式建议填写;compositionPlan 模式由段落时长决定

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

180000

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,用于后续查询结果