通过 Suno API 实现 AI音乐生成。提交提示、风格标签和歌词以生成歌曲。查询生成状态并下载音频或封面图片。适用于需要生成音乐的场景。
Suno Music.是一项面向实际任务的技能,主要用于Generate full songs (vocals + cultiples) 透過Suno API.是一项面向实际任务的技能,主要用于QQ快速启动.Commands.Command.;Command.;
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;
涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
通过 Suno API 生成完整歌曲(含人声与伴奏)。
# 设置您的 API 密钥 export SUNO_API_KEY="your_key_here" # 生成一首歌曲并等待其完成 python scripts/suno_api.py generate-and-wait --prompt "一首关于失去所爱之人的忧郁钢琴叙事曲" --tags "piano,ballad,sad,emotional" --style "Indie Pop" --title "Fading Light"
| 命令 | 描述 |
|---|---|
generate |
提交生成任务(非阻塞) |
status --ids |
查询已有生成任务的状态 |
generate-and-wait |
提交任务并轮询,直至完成 |
| 参数 | 默认值 | 描述 |
|---|---|---|
--prompt |
必填 | 歌词内容或歌曲描述 |
--tags |
(取自 prompt) | 风格标签,以英文逗号分隔 |
--style |
(取自 tags) | 音乐流派 / 风格 |
--title |
(取自 prompt) | 歌曲标题 |
--instrumental |
false | 仅生成纯器乐(无人声) |
--wait |
false | 等待首个音频片段生成完成 |
支持上述所有参数,并额外提供以下选项:
| 参数 | 默认值 | 描述 |
|---|---|---|
--poll-interval |
5 | 两次状态检查之间的间隔(单位:秒) |
--max-polls |
60 | 超时前最大轮询次数(默认为 5 分钟) |
https://api.sunoapi.org(可通过环境变量 SUNO_BASE_URL 覆盖)SUNO_API_KEY 提供的 Bearer TokenPENDING → TEXT_SUCCESS → FIRST_SUCCESS → SUCCESS当生成完成时,每个任务将返回以下字段:
audio_url — 音频下载链接(有效期约 15 天)image_url — 封面图链接title — 歌曲标题lyric — 完整歌词tags / style / durationpython scripts/suno_api.py generate --prompt "Summer vibes, beach party" --tags "pop,dance,summer" python scripts/suno_api.py status --ids "12345,12346"
python scripts/suno_api.py generate-and-wait --prompt "Cinematic orchestral build-up with brass" --tags "orchestral,cinematic,epic" --instrumental
SUNO_BASE_URL=https://your-suno-instance.com python scripts/suno_api.py generate --prompt "..."
suno_api.py — Suno API 的 Python 命令行客户端(支持 generate、status、generate-and-wait)相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习
最新文章