elevenlabs-music

# ElevenLabs Music Generation

Generate complete songs from text prompts with AI-generated lyrics and vocals.

## Quick Start

```bash
# Basic generation (30 seconds)
uv run {baseDir}/scripts/generate_music.py "upbeat jazz piano"

# Longer track (3 minutes)
uv run {baseDir}/scripts/generate_music.py "epic orchestral battle music" --length 180

# Instrumental only (no vocals)
uv run {baseDir}/scripts/generate_music.py "lo-fi hip hop beats" --length 120 --instrumental

# Custom output path
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.
```

## 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