| name | elevenlabs-music |
| description | Generate music from text prompts using ElevenLabs Eleven Music API. Use when creating songs, soundtracks, jingles, lullabies, or any audio music from descriptions. Supports vocals with AI-generated lyrics, instrumental tracks, and multiple genres/styles. Requires paid ElevenLabs plan. |
| author | G-HunterAi |
| license | MIT |
| version | 1.0.0 |
| tags | ["music","elevenlabs","audio","generation"] |
| platforms | ["macos","linux","windows"] |
| category | media |
| emoji | 🎹 |
| metadata | {"clawdbot":{"emoji":"🎹","requires":{"bins":["uv"],"env":["ELEVENLABS_API_KEY"]},"primaryEnv":"ELEVENLABS_API_KEY"}} |
ElevenLabs Music Generation
Generate complete songs from text prompts with AI-generated lyrics and vocals.
When to Use
- Creating original music from text descriptions
- Generating soundtracks for videos
- Producing jingles, lullabies, or ambient music
- Creating music in specific genres or styles
- Generating instrumental or vocal tracks
When NOT to Use
- Reproducing copyrighted songs or artist styles directly
- Generating music without paid ElevenLabs Creator plan
- Creating music that violates platform content policies
- Operating without valid ELEVENLABS_API_KEY environment variable
Quick Start
uv run {baseDir}/scripts/generate_music.py "upbeat jazz piano"
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
Options
| Flag | Description |
|---|
-l, --length | Duration in seconds (3-600, default: 30) |
-o, --output | Output file path (default: /tmp/music.mp3) |
-i, --instrumental | Force instrumental, no vocals |
Prompt Engineering Tips
Be Specific About Style
- Include genre, mood, tempo, and instruments
- Reference decades or eras: "90s Brazilian romantic pagode", "1960s sci-fi TV theme"
- Describe energy: "builds from soft to explosive", "relaxed and intimate"
For Vocals
- Specify language: "vocals in Portuguese", "singing in Japanese"
- Describe vocal style: "soulful male vocals", "ethereal female choir"
- Include lyrical themes: "about love and saudade", "celebrating friendship"
Avoid Copyright Issues
- Don't mention artist/band names directly
- Describe the style instead: "classic 90s romantic samba style" not "like Raça Negra"
- If rejected, the API returns a suggested alternative prompt
Example Prompts
MPB (Brazilian Popular Music)
A soulful MPB track featuring gentle acoustic guitar, warm nylon strings,
and dreamy Rhodes piano. Bossa nova-influenced rhythm with soft brushed
drums. Vocals in Portuguese express themes of saudade and the beauty of life.
Epic Orchestral
Epic military march with powerful brass fanfares, thundering timpani drums,
and a soaring choir. Triumphant and heroic, with deep bass tubas, bold
trumpets, snare rolls, and an anthemic melody building to a glorious crescendo.
Lullaby
Gentle orchestral lullaby with sweeping strings, soft brass, and ethereal
wordless soprano vocals. Peaceful yet majestic, evoking wonder and hope.
Perfect for falling asleep while dreaming of adventures.
Comedy Rock
Brazilian comedy rock with absurd, hilarious Portuguese lyrics full of
wordplay. Mix energetic rock guitars with unexpected rhythms - forró
breakdowns, pagode moments. Theatrical, exaggerated vocals singing about
ridiculous situations.
Error Handling
| Error | Cause | Solution |
|---|
Missing API key | ELEVENLABS_API_KEY not set | Set environment variable: export ELEVENLABS_API_KEY="your_key" |
401 Unauthorized | Invalid or expired API key | Verify key is correct and active in ElevenLabs account |
402 Payment Required | Plan doesn't support music API | Upgrade to Creator plan or higher |
400 Bad Request | Prompt violates content policy | Revise prompt; check API response for suggested alternative |
413 Content Too Large | Generated file exceeds limits | Reduce track length or simplify prompt |
Works Well With
- music-generation — Chain multiple music generation tasks
- ai-music-prompts — Generate prompts programmatically
- podcast-creator — Add background music to podcasts
- ffmpeg-video-editor — Combine generated music with video
Requirements
- ElevenLabs API Key: Set
ELEVENLABS_API_KEY environment variable
- Paid Plan: Music API requires Creator plan or higher
- uv: For running the Python script with dependencies
Supported Features
- Text-to-music generation up to 10 minutes
- AI-generated lyrics and vocals in multiple languages (English, Spanish, Portuguese, German, Japanese, etc.)
- Instrumental-only mode
- Most musical styles and genres
