ElevenLabs 音乐生成服务介绍
欢迎使用 ElevenLabs 音乐生成服务文档！
ElevenLabs 提供 AI 驱动的音乐生成能力，支持通过结构化作曲计划进行精细控制、视频配乐，以及专业级音轨分离。
支持的模型
| 模型 | 描述 |
|---|
music_v1 | ElevenLabs 旗舰音乐生成模型 |
功能一览
音乐生成
从简单文本提示或详细作曲计划生成音乐，支持段落级别精细控制
作曲计划
AI 生成结构化计划，包含段落、风格和歌词 — 免费，不消耗积分
音轨分离
将音频分离为 2 轨（人声+伴奏）或 6 个独立音轨
如何使用 ElevenLabs
选择输入方式
使用简单的 prompt 快速生成，或通过 /eleven/plan 创建 compositionPlan 来精细控制段落、风格和歌词。
生成音乐
调用 POST /eleven/music 传入提示词或作曲计划，获取 taskId。
轮询结果
使用 GET /eleven/tasks?taskId=xxx 轮询直到状态为 completed，结果包含生成的音频数据。
快速示例
curl -X POST "https://api.mountsea.ai/eleven/music" \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A melancholic indie folk song with acoustic guitar and soft vocals",
"model": "music_v1",
"musicLengthMs": 180000
}'
可用端点
| 端点 | 方法 | 描述 |
|---|
/eleven/music | POST | 从提示词或作曲计划生成音乐 |
/eleven/plan | POST | 创建作曲计划（免费，不消耗积分） |
/eleven/video-to-music | POST | 根据视频内容生成背景音乐 |
/eleven/tasks | GET | 查询任务状态和结果 |
/eleven/stems | POST | 音轨分离 |
/eleven/upload | POST | 上传音频用于 Inpainting 编辑（企业版） |
两种输入模式
ElevenLabs 支持两种互斥的音乐生成输入方式：
1. 简单提示模式
提供文本 prompt 描述所需音乐，简单快捷，AI 自动处理所有细节。
{
"prompt": "A melancholic indie folk song with acoustic guitar",
"model": "music_v1",
"musicLengthMs": 180000
}
2. 作曲计划模式
使用结构化的 compositionPlan，按段落精细控制风格、时长和歌词。可先通过 /eleven/plan 自动生成计划，再自定义后生成。
{
"compositionPlan": {
"positive_global_styles": ["epic orchestral", "cinematic"],
"negative_global_styles": ["lo-fi"],
"sections": [
{
"section_name": "Intro",
"positive_local_styles": ["soft piano", "building tension"],
"duration_ms": 15000
},
{
"section_name": "Verse",
"positive_local_styles": ["warm vocals", "acoustic guitar"],
"duration_ms": 30000,
"lines": ["Walking through the golden fields", "Sunlight on my face"]
}
]
},
"model": "music_v1",
"musicLengthMs": 180000
}
先使用 /eleven/plan 从简单提示生成作曲计划（免费），查看并自定义段落后再传给 /eleven/music。
输出格式
ElevenLabs 通过 outputFormat 参数支持多种输出格式：
| 格式 | 说明 |
|---|
mp3_44100_128 | MP3 44.1kHz 128kbps（默认） |
mp3_44100_192 | MP3 44.1kHz 192kbps（需 Creator 及以上） |
pcm_44100 | PCM 44.1kHz 无压缩（需 Pro 及以上） |
opus_48000_128 | Opus 48kHz 128kbps |
探索 API 文档
