Suno 音乐生成

国内用户请注意： 中国大陆用户请使用 https://toapis.cn 作为接口地址（Base URL）。文档示例中的 https://toapis.com 请替换为 https://toapis.cn。

Suno 音乐系列提供从生成、续写、剪辑、分轨到分析的完整 AI 音乐工作流。所有操作共用一个提交入口，通过 URL 路径中的 {operation} 区分：

POST https://toapis.com/v1/music/generations/{operation}

所有操作均为异步任务：提交后返回任务 ID，通过任务查询接口轮询结果。返回的音频、封面、视频等媒体 URL 均为本站 CDN 持久化地址，可长期访问。

Authorizations

Authorizationstring请求头必填

使用 Bearer Token 进行认证

获取 API Key：访问 API Key 管理页面

Authorization: Bearer YOUR_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

操作与定价

生成类

operation	说明	价格	Max
`generation`	音乐生成（默认操作）	$0.05 / 次	$0.10
`lyrics`	歌词生成	$0.008	-
`inspo`	参考音频灵感生成	$0.068	$0.136
`sounds`	音效生成	$0.0096	-
`upsampleTags`	风格标签扩写	$0.004	-

上传类

operation	说明	价格	Max
`uploadTask`	上传音频登记为任务	$0.004	-
`uploadCover`	上传音频并翻唱	$0.05	$0.10
`uploadExtend`	上传音频并续写	$0.05	$0.10

续写与改造类

operation	说明	价格	Max
`extend`	从指定时间点续写	$0.05	$0.10
`coverSong`	换风格翻唱	$0.05	$0.10
`remaster`	音质重制	$0.05	-
`mashup`	两首歌混编	$0.05	$0.10
`replaceMusic`	片段换写	$0.05	$0.10
`sample`	采样重编排（源需为上传产物）	$0.05	$0.10

分轨类

operation	说明	价格
`stems`	人声 / 伴奏分轨	$0.10
`stemsAll`	全乐器分轨	$0.24
`addStem`	新增一条乐器轨	$0.05（Max $0.10)
`addVocals`	为上传素材加人声（源需为上传产物）	$0.05（Max $0.10)
`addInstrumental`	为上传素材加伴奏（源需为上传产物）	$0.05（Max $0.10)

剪辑类

operation	说明	价格
`crop`	截取时间段	$0.008
`removeSection`	删除时间段	$0.008
`fadeIn`	开头淡入	$0.008
`fadeOut`	结尾淡出	$0.008
`adjustSpeed`	变速（可选保调）	$0.024
`concat`	拼接续写分段	$0.004

分析与导出类

operation	说明	价格
`midi`	音频转 MIDI 音符数据	$0.05
`bpm`	BPM 分析	$0.0008
`alignedLyrics`	歌词时间轴对齐	$0.0008
`download`	多格式下载（mp3/m4a/wav)	$0.0016
`generateMp4`	歌词视频包装	$0.004
`wav`	下载 WAV（旧版，建议用 `download`)	$0.0016

资产类（高级）

operation	说明	价格
`persona`	提取人声角色	$0.004
`createVoice`	克隆声音（需干净人声源）	$0.016
`vox`	人声提取（旧版，建议用 `persona`)	$0.004
`createModel`	自定义模型训练（6-24 条音频）	$0.96

任务生命周期

提交 → queued / in_progress → completed / failed

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

音乐生成

generation / inspo / sounds / lyrics

续写与上传

extend / uploadTask / uploadCover / uploadExtend

剪辑与改造

crop / fadeIn / fadeOut / replaceMusic / mashup / ...

分析与导出

midi / bpm / alignedLyrics / download / generateMp4