用途
elevenlabs-music 用于根据文本提示词生成完整的音乐作品。资料说明其基于 ElevenLabs Eleven Music API，适合创建歌曲、配乐、广告短曲、摇篮曲以及其他音频音乐内容。生成结果可包含 AI 生成的歌词与人声。
主要能力
资料列出的支持功能包括：文本到音乐的生成，时长最高约 10 分钟；多种语言的 AI 生成歌词与人声，例如英语、西班牙语、葡萄牙语、德语、日语等；纯器乐模式；以及支持大多数音乐风格与流派。
生成参数方面，脚本提供以下选项：
- 时长（-l, --length）：以秒为单位，范围 3 到 600，默认 30。
- 输出路径（-o, --output）：默认输出到 /tmp/music.mp3。
- 纯器乐（-i, --instrumental）：强制仅器乐，不使用人声。
使用方式
资料给出了快速开始示例，通过 uv 运行脚本：
# 基础生成（30 秒）
uv run {baseDir}/scripts/generate_music.py "upbeat jazz piano"
# 更长曲目（3 分钟）
uv run {baseDir}/scripts/generate_music.py "epic orchestral battle music" --length 180
# 仅器乐（无人声）
uv run {baseDir}/scripts/generate_music.py "lo-fi hip hop beats" --length 120 --instrumental
# 自定义输出路径
uv run {baseDir}/scripts/generate_music.py "romantic bossa nova" -o /tmp/bossa.mp3
提示词建议
资料提供了提示词工程方面的建议。在风格上应尽量具体，包括流派、情绪、节奏与乐器；可以参考年代或时期，例如“90 年代巴西浪漫 pagode”“1960 年代科幻电视剧主题”；描述能量变化，例如“由柔和逐渐到爆发”“轻松亲密”。在涉及人声时，可指定语言（如“葡萄牙语演唱”“日语演唱”）、描述演唱风格（如“深情的男声”“空灵的女声合唱”）、包含歌词主题（如“关于爱与 saudade”“庆祝友谊”）。
为避免版权问题，资料建议不要直接提及艺人或乐队名称，而应描述其风格，例如使用“经典 90 年代浪漫桑巴风格”而不是“像 Raça Negra”。如果请求被拒绝，API 会返回一个建议的替代提示词。
示例提示词
资料给出了几类示例提示词：
MPB（巴西流行音乐）：一首深情的 MPB 曲目，包含轻柔的原声吉他、温暖的尼龙弦与梦幻的 Rhodes 钢琴。受 bossa nova 影响的节奏，配以轻柔的刷鼓。葡萄牙语人声表达 saudade 主题与生活之美。
史诗管弦乐：史诗般的军队进行曲，带有强有力的铜管号角、雷鸣般的定音鼓与高亢的合唱。胜利而英雄气概，配以深沉的低音大号、嘹亮的小号、军鼓滚奏，以及逐渐推向辉煌高潮的颂歌式旋律。
摇篮曲：轻柔的管弦乐摇篮曲，带有舒展的弦乐、柔和的铜管与空灵的无词女高音。宁静而庄严，唤起惊奇与希望，适合在梦想冒险时入睡。
喜剧摇滚：巴西喜剧摇滚，带有荒诞搞笑的葡萄牙语歌词，充满文字游戏。将充满活力的摇滚吉他同意想不到的节奏混合，例如 forró 段落、pagode 时刻。戏剧化、夸张的人声，歌唱荒谬的情境。
适用场景
资料表明，该工具适用于创建歌曲、soundtracks（配乐）、jingles（广告短曲）、lullabies（摇篮曲）以及任何由文本提示生成的音频音乐。
限制与要求
使用前需要满足以下条件：需要 ElevenLabs API Key，通过设置 ELEVENLABS_API_KEY 环境变量提供；Music API 需要付费的 Creator 计划或更高版本；运行脚本需要 uv 以处理依赖。
资料未提供定价细节、平台支持范围（如操作系统或运行环境的具体版本）、生成效果的具体保证以及除上述示例之外的使用限制。