suno-music

📁 idanbeck/claude-skills 📅 5 days ago
3
总安装量
3
周安装量
#56293
全站排名
安装命令
npx skills add https://github.com/idanbeck/claude-skills --skill suno-music

Agent 安装分布

opencode 3
gemini-cli 3
github-copilot 3
codex 3
amp 3
kimi-cli 3

Skill 文档

Suno Music – AI Music Generation

Generate music using Suno AI’s API.

Setup (One-Time)

  1. Sign in to suno.ai
  2. Open browser DevTools (F12) → Console tab
  3. Run: document.cookie
  4. Find the __session=eyJ... part (it’s a long JWT token)
  5. Export it: export SUNO_COOKIE="__session=eyJ..."

Note: The __session token expires after ~1 hour. You’ll need to refresh it periodically.

Usage

Run the generation script:

python3 ~/.claude/skills/suno-music/generate_music.py "your prompt here" [options]

Options

Option Description Default
--custom Treat prompt as lyrics (not description) False
--tags Style/voice tags (e.g., “female voice, pop, upbeat”) None
--title Song title None
--instrumental Generate instrumental only (no vocals) False
--output Output directory path ./generated_music
--model Model key (e.g., chirp-auk-turbo) Default free model

Examples

Generate from description

python3 ~/.claude/skills/suno-music/generate_music.py "an upbeat electronic track for a tech product demo"

Custom lyrics with style

python3 ~/.claude/skills/suno-music/generate_music.py "[Verse 1]
Walking through the morning light
Everything feels just right" --custom --tags "indie folk, acoustic guitar, male voice" --title "Morning Light"

Instrumental track

python3 ~/.claude/skills/suno-music/generate_music.py "epic orchestral trailer music with building tension" --instrumental

Output

Songs are saved with format: {timestamp}_{sanitized_title}_{n}.mp3

Example: 20260106_morning_light_1.mp3

Suno generates 2 variations per request by default.

Credits

  • Free tier: 50 credits/day (renews daily)
  • Each generation uses 10 credits (5 per song × 2 variations)
  • So you can generate 5 songs per day on the free tier

Check remaining credits:

python3 ~/.claude/skills/suno-music/generate_music.py --credits

Models

Model Key Notes
v4.5-all chirp-auk-turbo Best free model (default)
v5 chirp-crow Pro only, beta
v4.5+ chirp-bluejay Pro only
v4 chirp-v4 Pro only

Requirements

  • Python 3.x
  • requests library (usually pre-installed)
  • SUNO_COOKIE environment variable with __session token

Troubleshooting

“API Error: 401” – Token expired. Get a fresh __session token from the browser.

“API Error: 402” – Out of credits. Wait for daily refresh or upgrade.