{"skill":{"slug":"suno-music-skill","displayName":"suno-music.skill","summary":"AI music generation via Suno API. Submit prompts, style tags, and lyrics to generate songs. Check generation status and download audio/cover art. Use when us...","description":"---\nname: suno-music\ndescription: AI music generation via Suno API. Submit prompts, style tags, and lyrics to generate songs. Check generation status and download audio/cover art. Use when user asks to create music, generate songs, compose tracks, or produce audio content with AI.\n---\n\n# Suno Music\n\nGenerate full songs (vocals + instrumentals) via the Suno API.\n\n## Quick Start\n\n```bash\n# Set your API key\nexport SUNO_API_KEY=\"your_key_here\"\n\n# Generate a song and wait for it to finish\npython scripts/suno_api.py generate-and-wait \\\n  --prompt \"A melancholic piano ballad about losing someone\" \\\n  --tags \"piano,ballad,sad,emotional\" \\\n  --style \"Indie Pop\" \\\n  --title \"Fading Light\"\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `generate` | Submit a generation task (non-blocking) |\n| `status --ids <ids>` | Check status of existing generation(s) |\n| `generate-and-wait` | Submit + poll until completion |\n\n## Full Options\n\n### generate\n\n| Flag | Default | Description |\n|------|---------|-------------|\n| `--prompt` | required | Lyrics or song description |\n| `--tags` | (prompt) | Style tags, comma-separated |\n| `--style` | (tags) | Music genre/style |\n| `--title` | (prompt) | Song title |\n| `--instrumental` | false | Instrumental only |\n| `--wait` | false | Wait for first audio chunk |\n\n### generate-and-wait\n\nAll of the above, plus:\n\n| Flag | Default | Description |\n|------|---------|-------------|\n| `--poll-interval` | 5 | Seconds between status checks |\n| `--max-polls` | 60 | Max polls before timeout (5min default) |\n\n## API & Key\n\n- **Base URL**: `https://api.sunoapi.org` (override via `SUNO_BASE_URL`)\n- **Auth**: Bearer token via `SUNO_API_KEY`\n- **Status flow**: `PENDING` → `TEXT_SUCCESS` → `FIRST_SUCCESS` → `SUCCESS`\n\n## Output Fields\n\nWhen complete, each generation includes:\n\n- `audio_url` — Download link (expires ~15 days)\n- `image_url` — Cover art\n- `title` — Song title\n- `lyric` — Full lyrics\n- `tags` / `style` / `duration`\n\n## Examples\n\n### Generate multiple songs from one prompt\n\n```bash\npython scripts/suno_api.py generate --prompt \"Summer vibes, beach party\" --tags \"pop,dance,summer\"\npython scripts/suno_api.py status --ids \"12345,12346\"\n```\n\n### Instrumental only\n\n```bash\npython scripts/suno_api.py generate-and-wait \\\n  --prompt \"Cinematic orchestral build-up with brass\" \\\n  --tags \"orchestral,cinematic,epic\" \\\n  --instrumental\n```\n\n### Custom API endpoint (e.g., self-hosted)\n\n```bash\nSUNO_BASE_URL=https://your-suno-instance.com \\\n  python scripts/suno_api.py generate --prompt \"...\"\n```\n\n## Resources\n\n### scripts/\n- `suno_api.py` — Python CLI client for Suno API (generate, status, generate-and-wait)\n","topics":["Music Generation","Audio"],"tags":{"latest":"1.0.1"},"stats":{"comments":0,"downloads":374,"installsAllTime":14,"installsCurrent":0,"stars":0,"versions":2},"createdAt":1778373088371,"updatedAt":1778492888959},"latestVersion":{"version":"1.0.1","createdAt":1778373488399,"changelog":"- Initial release of the Suno Music skill.\n- Added Python CLI client (scripts/suno_api.py) for AI music generation via the Suno API.\n- Supports generating full songs, checking generation status, and downloading audio/cover art.\n- Includes command-line options for prompts, style tags, lyrics, and more.","license":"MIT-0"},"metadata":null,"owner":{"handle":"kennedydqz-del","userId":"s1780y952579p3jdasgkva4w8186ddrd","displayName":"kennedydqz-del","image":"https://avatars.githubusercontent.com/u/259596298?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780090775468}}