beatoven

1# Beatoven.ai
2 
3## Purpose
4Compose royalty-free music with Beatoven's public composition API: text-to-music (also audio-to-music and video-to-music prompts), task polling, track download, and individual stems (bass, chords, melody, percussion), plus SFX via the maestro model. Beatoven is Fairly Trained certified (licensed training data), so output is commercially safe, and it is the only verified self-serve music API in the catalog (Suno and Udio have no public APIs). Also available on the fal.ai marketplace.
5 
6## Tooling
7All commands go through `bin/beatoven.py`:
8 
9```bash
10bin/beatoven.py auth                                                      # verify credential setup (no spend)
11bin/beatoven.py compose --prompt "30 seconds peaceful lo-fi chill hop track" --format wav
12bin/beatoven.py compose --prompt "upbeat podcast intro" --format mp3 --looping
13bin/beatoven.py status --task-id <task_id>                                # poll until composed
14bin/beatoven.py download --task-id <task_id> --out track.wav              # download the composed track
15bin/beatoven.py download --url https://.../track.wav --out track.wav      # download from a track URL directly
16bin/beatoven.py stems --task-id <task_id>                                 # list the four stem URLs
17bin/beatoven.py stems --task-id <task_id> --stem bass --out bass.wav      # download one stem
18```
19…