← 返回 Skills 市场

suno-music.skill

Name: suno-music.skill
Author: kennedydqz-del

作者 kennedydqz-del · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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...

使用说明 (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 via SUNO_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 art
title — Song title
lyric — Full lyrics
tags / 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)

安全使用建议

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.

功能分析

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.

能力标签

requires-oauth-tokenrequires-sensitive-credentials

能力评估

ℹ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install suno-music-skill
安装完成后，直接呼叫该 Skill 的名称或使用 /suno-music-skill 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug suno-music-skill

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题

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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 29 次。

如何安装 suno-music.skill？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install suno-music-skill」即可一键安装，无需额外配置。

suno-music.skill 是免费的吗？

是的，suno-music.skill 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

suno-music.skill 支持哪些平台？

suno-music.skill 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 suno-music.skill？

由 kennedydqz-del（@kennedydqz-del）开发并维护，当前版本 v1.0.1。