Skip to main content
国内用户请注意： 中国大陆用户请使用 https://toapis.cn 作为接口地址（Base URL）。文档示例中的 https://toapis.com 请替换为 https://toapis.cn。
Suno 音乐系列提供从生成、续写、剪辑、分轨到分析的完整 AI 音乐工作流。所有操作共用一个提交入口，通过 URL 路径中的 {operation} 区分：
所有操作均为异步任务：提交后返回任务 ID，通过任务查询接口轮询结果。返回的音频、封面、视频等媒体 URL 均为本站 CDN 持久化地址，可长期访问。

​
Authorizations

​
string
必填
使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面

​
通用说明

  • 请求体中的 model 固定为 "suno"
  • 涉及已有作品的操作传 task_id（本平台任务 ID,tsk_aud_ 前缀），部分操作再搭配 audio_index 指定曲目序号
  • custom 控制模式：为 true 时 prompt 按自定义歌词处理，title/style/negative_tags 生效；为 false（或不传）时为灵感模式，prompt/gpt_description 按一段音乐描述处理
  • max_mode 为高质量档位，价格为普通档两倍，仅对支持的操作生效（见下表 Max 列），且其中带 custom 的操作要求 effective custom 为 true

​
操作与定价

​
生成类

​
上传类

​
续写与改造类

​
分轨类

​
剪辑类

​
分析与导出类

​
资产类（高级）

​
任务生命周期

  • 任务失败时预扣费用自动退还
  • download/midi/bpm/alignedLyrics 等结果返回结构化数据，详见 任务状态查询

音乐生成

generation / inspo / sounds / lyrics

续写与上传

extend / uploadTask / uploadCover / uploadExtend

剪辑与改造

crop / fadeIn / fadeOut / replaceMusic / mashup / …

分析与导出

midi / bpm / alignedLyrics / download / generateMp4