ACE Music - AI Music Generation

Generate music via ACE Music's free hosted API (ACE-Step 1.5 model).

Setup

API Key is stored in env ACE_MUSIC_API_KEY. If not set:

1. Open https://acemusic.ai/playground/api-key in the browser for the user
2. Ask them to sign up (free) and paste the API key
3. Store it: add ACE_MUSIC_API_KEY=<key> to your .env or TOOLS.md, or set via PowerShell: $env:ACE_MUSIC_API_KEY="<key>"

Quick Generation

Use scripts/generate.py for one-shot generation. It reads ACE_MUSIC_API_KEY from the environment and prints the saved file path(s) to stdout.

# Simple prompt (AI decides everything)
python scripts/generate.py "upbeat pop song about summer" --duration 30 --output summer.mp3