Skip to main content
POST
續寫與上傳
本頁覆蓋四個操作,共用一個入口,路徑中的 {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