通过 Suno API 实现 AI音乐生成。提交提示、风格标签和歌词以生成歌曲。查询生成状态并下载音频或封面图片。适用于需要生成音乐的场景。
Suno Music.
功能概述
Suno Music.是一项面向实际任务的技能,主要用于Generate full songs (vocals + cultiples) 透過Suno API.是一项面向实际任务的技能,主要用于QQ快速启动.Commands.Command.;Command.;
核心要点
- Description.generate. 提交一代任务(非屏蔽). status - ids <idsXXXCheck 状态;
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;
结果检查与注意事项
涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
Suno 音乐
通过 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 |
提交任务并轮询,直至完成 |
全部参数选项
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 Token - 状态流转:
PENDING→TEXT_SUCCESS→FIRST_SUCCESS→SUCCESS
输出字段
当生成完成时,每个任务将返回以下字段:
audio_url— 音频下载链接(有效期约 15 天)image_url— 封面图链接title— 歌曲标题lyric— 完整歌词tags/style/duration
示例
基于同一提示词生成多首歌曲
python 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
使用自定义 API 端点(例如自托管实例)
SUNO_BASE_URL=https://your-suno-instance.com python scripts/suno_api.py generate --prompt "..."
资源
scripts/ 目录
suno_api.py— Suno API 的 Python 命令行客户端(支持 generate、status、generate-and-wait)
热门AI工具
相关专题
本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。
0
2026.11.06
围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。
0
2026.11.06
详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。
0
2026.11.06
DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
0
2026.11.05
DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。
0
2026.11.05
本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。
0
2026.11.04
本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。
0
2026.11.04
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.8万人学习
共6课时 | 54.7万人学习
最新文章