suno-music.skill

该 Skill 封装 Suno API 的 Python 命令行客户端，可根据提示词、风格标签和歌词提交音乐生成任务，查询状态并轮询等待完成；输出生成状态、音频链接、封面图、标题、歌词和标签等字段。使用前需配置 SUNO_API_KEY，音乐生成依赖外部服务。

kennedydqz-del

热度 44.42

最近更新 2026-05-11 17:48:08

分类：创作依赖：代码执行 / 第三方 API应用场景：API 集成 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add suno-music-skill

Metadata

name: suno-music
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 user asks to create music, generate songs, compose tracks, or produce audio content with AI.

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 <ids>`	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)