suno

CLI for Suno AI music generation. Reverse-engineered API — no official SDK needed.

Setup

# Build
CGO_ENABLED=0 go build -o suno .

# Save your Suno cookie (grab from browser dev tools)
./suno cookie "__client=abc123..."

Usage

suno generate [flags] <prompt>     Generate a song
suno status <id> [id...]           Check song status
suno download <id> [id...]         Download songs
suno credits                       Check credits
suno cookie [value]                Save cookie
suno publish <id>                  Make song public
suno unpublish <id>                Make song private
suno persona list|get|create|...   Manage personas

Generate flags

Flag	Description
-s, --style	Style/genre tags
-x, --exclude	Negative style tags
-t, --title	Song title
-m, --model	Model: crow, v4, v4.5, v5 (default: crow)
-g, --gender	Vocal gender: m or f
-w, --weirdness	0.0–1.0 (0=normal, 1=weird)
-p, --persona	Persona ID to use
--style-weight	0.0–1.0 style influence
--mumble	Mumble/vocalise mode
--describe	Description mode (AI writes lyrics)
--instrumental	Instrumental only
--no-wait	Don't wait for completion
--no-download	Don't auto-download

Examples

# Custom lyrics with style
suno generate -s "indie rock male vocals" -t "My Song" "verse lyrics here..."

# AI-written from description
suno generate --describe "upbeat summer pop song about coding"

# With persona
suno generate -p <persona-id> -s "lo-fi" "chill lyrics..."

Personas

suno persona list                  # List your personas
suno persona get <id>              # Get details
suno persona create <clip_id>      # Create from existing clip
suno persona followed              # Followed personas
suno persona loved                 # Loved personas
suno persona love <id>             # Toggle love

Auth

Uses Clerk session auth. Grab your __client cookie from suno.com (browser dev tools → Application → Cookies) and save it with suno cookie.

Cookie is stored at ~/.config/suno/cookie.txt.

License

Private. Do not distribute.