ace-musicGenerate AI music using ACE-Step 1.5 via ACE Music's free API. Use when the user asks to create, generate, or compose music, songs, beats, instrumentals, or...
Install via ClawdBot CLI:
clawdbot install fspecii/ace-musicGenerate music via ACE Music's free hosted API (ACE-Step 1.5 model).
API Key is stored in env ACE_MUSIC_API_KEY. If not set:
export ACE_MUSIC_API_KEY= or add to TOOLS.mdUse scripts/generate.sh for one-shot generation:
# Simple prompt (AI decides everything)
scripts/generate.sh "upbeat pop song about summer" --duration 30 --output summer.mp3
# With lyrics
scripts/generate.sh "gentle acoustic ballad, female vocal" \
--lyrics "[Verse 1]\nSunlight through the window\n\n[Chorus]\nWe are the dreamers" \
--duration 60 --output ballad.mp3
# Instrumental only
scripts/generate.sh "lo-fi hip hop beats, chill, rainy day" --instrumental --duration 120 --output lofi.mp3
# Natural language (AI writes everything)
scripts/generate.sh "write me a jazz song about coffee" --sample-mode --output jazz.mp3
# Specific settings
scripts/generate.sh "rock anthem" --bpm 140 --key "E minor" --language en --seed 42 --output rock.mp3
# Multiple variations
scripts/generate.sh "electronic dance track" --batch 3 --output edm.mp3Script outputs file path(s) to stdout. Send the file to the user.
For covers, repainting, or audio input β see references/api-docs.md for full API spec.
Key task types:
text2music (default) β generate from text/lyricscover β cover an existing song (requires audio input)repaint β modify a section of existing audio| Want | Use |
|------|-----|
| Specific style | Describe in prompt: "jazz, saxophone solo, smoky bar" |
| Custom lyrics | --lyrics "[Verse]...[Chorus]..." |
| AI writes everything | --sample-mode |
| No vocals | --instrumental |
| Longer songs | --duration 120 (seconds) |
| Specific tempo | --bpm 120 |
| Specific key | --key "C major" |
| Multiple outputs | --batch 3 |
| Reproducible | --seed 42 |
| Non-English vocals | --language ja (zh, en, ja, ko, etc.) |
https://api.acemusic.aiGenerated Mar 1, 2026
Creators generate custom background music or full songs for YouTube videos, TikTok clips, and podcasts to enhance engagement without licensing fees. They can quickly produce tracks matching specific moods or themes, such as upbeat intros or ambient background loops.
Artists use the tool to draft song ideas, experiment with genres, or create demos with AI-generated vocals and lyrics. It helps in brainstorming melodies and arrangements before investing in studio recording, saving time and resources.
Educators and trainers generate custom audio tracks for e-learning modules, presentations, or language lessons, using prompts to create songs in specific languages or styles. This makes learning more interactive and engaging for students.
Marketers produce unique jingles or background music for commercials, online ads, and brand videos tailored to target audiences. They can iterate quickly on variations to test different emotional tones or cultural adaptations.
Developers create dynamic soundtracks, ambient music, or sound effects for games and mobile apps based on in-game events or user interactions. The free API allows for cost-effective audio generation without subscription limits.
Offer the core music generation for free via API to attract users, then monetize through paid tiers for advanced features like higher quality audio, faster processing, or commercial licensing. This model builds a large user base while generating revenue from power users and businesses.
License the AI music generation technology to companies in media, education, or gaming for integration into their own platforms. Provide custom branding, dedicated support, and tailored features, charging based on usage volume or annual contracts.
Create a platform where users can generate, share, and sell their AI-created music tracks. Monetize through commissions on sales, premium listings, or subscription access to exclusive content, fostering a community of creators and buyers.
π¬ Integration Tip
Set the ACE_MUSIC_API_KEY environment variable first; use the provided scripts for quick generation and refer to API docs for advanced features like covers.
Terminal Spotify playback/search via spogo (preferred) or spotify_player.
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Download videos from YouTube, Bilibili, Twitter, and thousands of other sites using yt-dlp. Use when the user provides a video URL and wants to download it, extract audio (MP3), download subtitles, or select video quality. Triggers on phrases like "δΈθ½½θ§ι’", "download video", "yt-dlp", "YouTube", "Bη«", "ζι³", "ζει³ι’", "extract audio".
Search and add movies to Radarr. Supports collections, search-on-add option.
Control Spotify playback on macOS. Play/pause, skip tracks, control volume, play artists/albums/playlists. Use when a user asks to play music, control Spotify, change songs, or adjust Spotify volume.
Search and add TV shows to Sonarr. Supports monitor options, search-on-add.