← Back to Skills Marketplace
suno-music.skill
by
kennedydqz-del
· GitHub ↗
· v1.0.1
· MIT-0
29
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install suno-music-skill
Description
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...
README (SKILL.md)
Suno Music
Generate full songs (vocals + instrumentals) via the Suno API.
Quick Start
# Set your API key
export SUNO_API_KEY="your_key_here"
# Generate a song and wait for it to finish
python scripts/suno_api.py generate-and-wait \
--prompt "A melancholic piano ballad about losing someone" \
--tags "piano,ballad,sad,emotional" \
--style "Indie Pop" \
--title "Fading Light"
Commands
| Command | Description |
|---|---|
generate |
Submit a generation task (non-blocking) |
status --ids \x3Cids> |
Check status of existing generation(s) |
generate-and-wait |
Submit + poll until completion |
Full Options
generate
| Flag | Default | Description |
|---|---|---|
--prompt |
required | Lyrics or song description |
--tags |
(prompt) | Style tags, comma-separated |
--style |
(tags) | Music genre/style |
--title |
(prompt) | Song title |
--instrumental |
false | Instrumental only |
--wait |
false | Wait for first audio chunk |
generate-and-wait
All of the above, plus:
| Flag | Default | Description |
|---|---|---|
--poll-interval |
5 | Seconds between status checks |
--max-polls |
60 | Max polls before timeout (5min default) |
API & Key
- Base URL:
https://api.sunoapi.org(override viaSUNO_BASE_URL) - Auth: Bearer token via
SUNO_API_KEY - Status flow:
PENDING→TEXT_SUCCESS→FIRST_SUCCESS→SUCCESS
Output Fields
When complete, each generation includes:
audio_url— Download link (expires ~15 days)image_url— Cover arttitle— Song titlelyric— Full lyricstags/style/duration
Examples
Generate multiple songs from one prompt
python scripts/suno_api.py generate --prompt "Summer vibes, beach party" --tags "pop,dance,summer"
python scripts/suno_api.py status --ids "12345,12346"
Instrumental only
python scripts/suno_api.py generate-and-wait \
--prompt "Cinematic orchestral build-up with brass" \
--tags "orchestral,cinematic,epic" \
--instrumental
Custom API endpoint (e.g., self-hosted)
SUNO_BASE_URL=https://your-suno-instance.com \
python scripts/suno_api.py generate --prompt "..."
Resources
scripts/
suno_api.py— Python CLI client for Suno API (generate, status, generate-and-wait)
Usage Guidance
Install only if you trust the Suno API service and are comfortable sending your prompts, lyrics, and generated-song metadata to it. Before use, confirm or remove the default callback behavior, verify SUNO_BASE_URL, and protect SUNO_API_KEY as a sensitive account credential.
Capability Analysis
Type: OpenClaw Skill
Name: suno-music-skill
Version: 1.0.1
The skill bundle provides a comprehensive CLI client for the Suno AI music generation service via the unofficial sunoapi.org API. The Python script `scripts/suno_api.py` implements standard API interactions for music generation, status tracking, and file uploads (to `sunoapiorg.redpandaai.co`), all of which are consistent with the stated purpose in `SKILL.md`. No evidence of malicious behavior, data exfiltration, or prompt injection was found.
Capability Tags
Capability Assessment
Purpose & Capability
The main behavior matches the stated purpose of generating and checking AI music via the Suno API.
Instruction Scope
The instructions disclose the Suno API base URL and API key, but they do not disclose that generation requests include a default callback URL.
Install Mechanism
There is no install spec or remote installer; the skill includes a Python script and no static scan findings were reported.
Credentials
The script sends prompts and generation metadata to an external API, which is expected, but the fixed default callback creates an additional data-flow users may not expect.
Persistence & Privilege
The skill uses a SUNO_API_KEY bearer token; this is purpose-aligned but gives the tool access to the user's Suno API account and credits.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install suno-music-skill - After installation, invoke the skill by name or use
/suno-music-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Initial release of the Suno Music skill.
- Added Python CLI client (scripts/suno_api.py) for AI music generation via the Suno API.
- Supports generating full songs, checking generation status, and downloading audio/cover art.
- Includes command-line options for prompts, style tags, lyrics, and more.
v1.0.0
Initial release of Suno Music Skill:
- Generate full songs (vocals and instrumentals) using the Suno API with prompts, tags, styles, and lyrics.
- Check the status of song generation tasks and download audio or cover art.
- Supports both blocking and non-blocking generation workflows.
- CLI options for customizing prompts, tags, styles, and more, including instrumental tracks and custom API endpoints.
- Detailed documentation with usage examples and command reference.
Metadata
Frequently Asked Questions
What is suno-music.skill?
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... It is an AI Agent Skill for Claude Code / OpenClaw, with 29 downloads so far.
How do I install suno-music.skill?
Run "/install suno-music-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is suno-music.skill free?
Yes, suno-music.skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does suno-music.skill support?
suno-music.skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created suno-music.skill?
It is built and maintained by kennedydqz-del (@kennedydqz-del); the current version is v1.0.1.
More Skills