Suno CLI
Install#
pip install suno-cli # or: uv pip install suno-cliQuick start#
export ACEDATACLOUD_API_TOKEN=your_token_here
suno generate "A happy birthday song with acoustic guitar"
suno custom -l "[Verse]\nHello world\n[Chorus]\nLa la la" -t "Hello" -s "pop, upbeat"
suno wait <task-id> --interval 5Commands#
| Group | Examples |
|---|---|
| Generation | generate, custom, extend, cover, remaster, mashup |
| Lyrics | lyrics, mashup-lyrics, optimize-style |
| Media | mp4, wav, midi, timing, vocals |
| Persona & upload | persona, personas, voice, upload |
| Task management | task, tasks, wait |
30+ commands in total — run suno --help for the full list, or see the GitHub repo for the complete reference.
Models#
Defaults to chirp-v5-5 (up to 8 minutes). Older chirp-v3 through v4.5 versions are available for shorter, faster generations.
Configuration#
| Variable | Default |
|---|---|
ACEDATACLOUD_API_TOKEN |
required |
ACEDATACLOUD_API_BASE_URL |
https://api.acedata.cloud |
SUNO_DEFAULT_MODEL |
chirp-v5-5 |
SUNO_REQUEST_TIMEOUT |
1800 |