Suno 音乐
续写与上传
extend 续写已有歌曲,uploadTask/uploadCover/uploadExtend 上传素材
国内用户请注意: 中国大陆用户请使用 https://toapis.cn 作为接口地址(Base URL)。文档示例中的 https://toapis.com 请替换为 https://toapis.cn。
本页覆盖四个操作,共用一个入口,路径中的 {operation} 决定行为:
POST https://toapis.com/v1/music/generations/{operation}Authorizations
Authorizationstring请求头必填使用 Bearer Token 进行认证,获取 API Key:API Key 管理页面
extend — 续写歌曲($0.05,Max $0.10)
从已有任务的指定时间点继续生成。custom 默认 true(续写通常带歌词)。
modelstring请求体必填固定
"suno"task_idstring请求体必填源任务 ID
continue_atnumber请求体必填续写起点(秒)
audio_indexnumber请求体源曲目序号(任务含多轨时使用)
promptstring请求体续写歌词(custom 模式)
titlestring请求体标题
stylestring请求体风格标签
max_modeboolean请求体Max 档 $0.10
curl --request POST \
--url https://toapis.com/v1/music/generations/extend \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"model":"suno","task_id":"tsk_aud_xxx","continue_at":60,"prompt":"[Chorus] 副歌歌词..."}'uploadTask — 上传音频登记($0.004)
将公网音频登记为任务,产物可作为 sample/addVocals/addInstrumental/addStem 的源(这几类操作只接受上传源)。
modelstring请求体必填固定
"suno"audioFilePathstring请求体必填公网可访问的音频 URL
只传
model + audioFilePath,不要附带 version 等多余字段。curl --request POST \
--url https://toapis.com/v1/music/generations/uploadTask \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"model":"suno","audioFilePath":"https://example.com/my-vocals.mp3"}'uploadCover — 上传翻唱($0.05,Max $0.10)
上传音频并用指定风格翻唱。
modelstring请求体必填固定
"suno"audio_urlstring请求体必填源音频 URL
customboolean请求体自定义歌词模式
promptstring请求体歌词(custom=true) / 描述
gpt_descriptionstring请求体灵感描述(custom=false 时必填)
stylestring请求体目标风格
persona_idstring请求体人声角色,与
custom_model_id 互斥max_modeboolean请求体Max 档
uploadExtend — 上传续写($0.05,Max $0.10)
上传音频并从指定时间点续写,恒按自定义模式处理。
modelstring请求体必填固定
"suno"audio_urlstring请求体必填源音频 URL
continue_atnumber请求体必填续写起点(秒)
promptstring请求体续写歌词
stylestring请求体风格
max_modeboolean请求体Max 档
Response
task_idstring任务 ID,用于查询状态
statusstringsubmitted