Skip to main content
POST
续写与上传
国内用户请注意: 中国大陆用户请使用 https://toapis.cn 作为接口地址(Base URL)。文档示例中的 https://toapis.com 请替换为 https://toapis.cn。
本页覆盖四个操作,共用一个入口,路径中的 {operation} 决定行为:

Authorizations

string
必填
使用 Bearer Token 进行认证,获取 API Key:API Key 管理页面

extend — 续写歌曲(0.05,Max0.05,Max 0.10)

从已有任务的指定时间点继续生成。custom 默认 true(续写通常带歌词)。
string
必填
固定 "suno"
string
必填
源任务 ID
number
必填
续写起点(秒)
number
源曲目序号(任务含多轨时使用)
string
续写歌词(custom 模式)
string
标题
string
风格标签
boolean
Max 档 $0.10

uploadTask — 上传音频登记($0.004)

将公网音频登记为任务,产物可作为 sample/addVocals/addInstrumental/addStem 的源(这几类操作只接受上传源)。
string
必填
固定 "suno"
string
必填
公网可访问的音频 URL
只传 model + audioFilePath,不要附带 version 等多余字段。

uploadCover — 上传翻唱(0.05,Max0.05,Max 0.10)

上传音频并用指定风格翻唱。
string
必填
固定 "suno"
string
必填
源音频 URL
boolean
自定义歌词模式
string
歌词(custom=true) / 描述
string
灵感描述(custom=false 时必填)
string
目标风格
string
人声角色,与 custom_model_id 互斥
boolean
Max 档

uploadExtend — 上传续写(0.05,Max0.05,Max 0.10)

上传音频并从指定时间点续写,恒按自定义模式处理。
string
必填
固定 "suno"
string
必填
源音频 URL
number
必填
续写起点(秒)
string
续写歌词
string
风格
boolean
Max 档

Response

string
任务 ID,用于查询状态
string
submitted