ToAPIsToAPIs
Suno 音樂

續寫與上傳

extend 續寫已有歌曲,uploadTask/uploadCover/uploadExtend 上傳素材

POST
/v1/music/generations/extend

本頁覆蓋四個操作,共用一個入口,路徑中的 {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,用於查詢狀態
statusstring
submitted