音乐生成
ElevenLabs
生成音乐
从文本提示或作曲计划创建音乐
POST
音乐生成
使用 ElevenLabs music_v1 模型生成音乐。支持两种互斥的输入模式:
- 提示模式:提供简单文本
prompt— 快速便捷 - 作曲计划模式:提供结构化的
compositionPlan,按段落精细控制风格、时长和歌词
这是一个异步任务。响应中包含
taskId — 使用获取任务状态轮询生成的音频。模式说明
简单提示
设置prompt 描述所需音乐。可选设置 forceInstrumental: true 生成纯器乐。
作曲计划
设置compositionPlan,包含 positive_global_styles、negative_global_styles 和 sections 数组。每个段落可有独立的 section_name、positive_local_styles、negative_local_styles、duration_ms 和 lines(歌词)。
详细模式
设置detailed: true 可在结果中获取歌词时间戳等元数据,对应 ElevenLabs 的 /v1/music/detailed 端点。授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
模型 ID
可用选项:
music_v1 示例:
"music_v1"
简单文字提示(与 compositionPlan 互斥)
示例:
"A melancholic indie folk song with acoustic guitar and soft vocals"
详细作曲计划(与 prompt 互斥,通过 /eleven/plan 生成)
歌曲长度(毫秒),范围 3000-600000ms。prompt 模式建议填写;compositionPlan 模式由段落时长决定
必填范围:
3000 <= x <= 600000示例:
180000
随机种子
示例:
877369
强制纯器乐,仅 prompt 模式
是否严格遵守段落时长,仅 compositionPlan 模式
输出格式,格式为 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 是否保存生成结果用于后续 Inpainting 编辑。仅限具备 Inpainting 权限的企业客户使用
是否使用 C2PA 签名标记 AI 生成内容。仅适用于 MP3 输出格式,会在文件中嵌入加密的 AI 生成来源证明
响应
200 - application/json
任务创建成功
任务 ID,用于后续查询结果