Skip to main content
使用 AI 生成音樂和歌詞。這是一個非同步 API。建立回應會返回任務身分,並且在可用時返回優先使用的 poll_url

請求參數

string
預設值:"suno_music"
要使用的模型:suno_music 用於音樂生成,suno_lyrics 僅用於歌詞。
string
生成音樂的描述。音樂、歌詞、upload-cover 和 upload-extend 請求必填;add-instrumental 可省略。
string
生成歌曲的標題。
string
風格標籤(例如:“pop, upbeat, electronic”)。
string
需要避開的風格。audio_operationadd-instrumental 時必填。
string
生成類型:MUSIC(預設)或 LYRICS
string
官方 Suno 模型版本。音樂生成必填(省略 action 或使用 MUSIC 時);僅歌詞請求請省略。支持值:chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5
boolean
設為 true 時生成無人聲的純音樂。
string
可公開存取的參考/上傳音訊 URL。提供此欄位但不傳 audio_operation 時,預設使用 upload-cover 流程。
string
上傳音訊模式:upload-coverupload-extendadd-instrumentalupload-extend 需要 continue_atadd-instrumental 需要 audio_urltitletagsnegative_tags
string
要續接的前一個片段 ID。
number
續寫的起始時間戳(秒)。audio_operationupload-extend 時必填。

回應

string
用於輪詢狀態的任務 ID。
string
適配器返回時的非同步任務 ID 別名。
string
可用時返回的優先輪詢 URL。
string
任務狀態:pendingprocessingcompletedfailed
integer
任務建立的 Unix 時間戳記。