suno-music.skill — Suno Music 技能

通过Suno API生成完整的歌曲（人声+器乐）。快速开始 # 设置API密钥 export SUNO_API_KEY="你的密钥" # 生成一首歌曲并等待完成 python scripts/suno_api.py generate-and-wait \ --prompt "关于失去某人的忧郁钢琴抒情曲" \ --tags "钢琴,抒情曲,悲伤,情感" \ --style "独立流行" \ --title "渐逝的光芒"

命令 命令描述 generate 提交生成任务（非阻塞） status --ids 检查现有生成的状态 generate-and-wait 提交并轮询直到完成

全选项 generate 标志 默认值 描述 --prompt 必需 歌词或歌曲描述 --tags （prompt） 样式标签，逗号分隔 --style （tags） 音乐流派/样式 --title （prompt） 歌曲标题 --instrumental false 仅器乐 --wait false 等待第一个音频块

generate-and-wait 包括上述所有选项，以及： 标志 默认值 描述 --poll-interval 5 状态检查之间的秒数 --max-polls 60 超时之前的最大轮询次数（默认5分钟）

API和密钥 基础URL：https://api.sunoapi.org（通过SUNO_BASE_URL覆盖） 认证：通过SUNO_API_KEY的Bearer令牌 状态流：PENDING → TEXT_SUCCESS → FIRST_SUCCESS → SUCCESS

输出字段 完成后，每个生成包括： audio_url — 下载链接（过期约15天） image_url — 封面艺术 title — 歌曲标题 lyric — 全歌词 tags / style / duration

示例 生成多首歌曲从一个提示 python scripts/suno_api.py generate --prompt "夏日氛围，海滩派对" --tags "流行,舞蹈,夏日" python scripts/suno_api.py status --ids "12345,12346" 仅器乐 python scripts/suno_api.py generate-and-wait \ --prompt "电影管弦乐的建立，带有铜管" \ --tags "管弦乐,电影,史诗" \ --instrumental 自定义API端点（例如，自托管） SUNO_BASE_URL=https://your-suno-instance.com \ python scripts/suno_api.py generate --prompt "..."

资源 scripts/ suno_api.py — Suno API的Python CLI客户端（generate, status, generate-and-wait）