建立音樂

音樂模型 ID，例如 suno-music。僅產生歌詞時，請選擇目前公開操作包含 lyrics 的模型。

音樂描述或替換文字。音樂、歌詞、upload-cover、upload-extend 和 replace-section 請求必填；add-instrumental 和分軌請求可省略。

生成歌曲的標題。

風格標籤（例如："pop, upbeat, electronic"）。

需要避開的風格。audio_operation 為 add-instrumental 時必填。

可選值為 MUSIC 或 LYRICS。請選擇支援對應公開操作的模型；此欄位不會讓僅支援音樂的模型具備歌詞能力。

Suno 版本選擇器。生成、upload-cover、upload-extend、add-instrumental 及以 audio_url 為來源的替換請求必填。歌詞、以 task_id + audio_id 為來源的替換及分軌請求請省略。支援值： 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.

設為 true 時生成無人聲的純音樂。

可公開存取的參考/上傳音訊 URL。提供此欄位但不傳 audio_operation 時，預設使用 upload-cover 流程。

音訊操作： upload-cover, upload-extend, add-instrumental, replace-section, vocal-separate, multi-stem-separation, advanced-split.

vocal-separate、multi-stem-separation 和 advanced-split 需要 task_id + audio_id；advanced-split 還需要 stem_name。upload-extend 需要大於 0 的 continue_at。add-instrumental 需要 audio_url、title、tags 和 negative_tags。

replace-section 必須提供 prompt、tags、title、infill_start_s、infill_end_s 和 full_lyrics。來源只能二選一：task_id + audio_id，或 audio_url + mv。替換區間必須為 6–60 秒。

本組織擁有的來源任務 ID，用於生成音訊的分段替換或分軌。

來源任務結果回傳的音訊 ID。替換已生成音訊及分軌時，需與 task_id 一起提供。

替換區間的起始秒數，必須大於等於 0。replace-section 必填。

替換區間的結束秒數。replace-section 必填，必須比 infill_start_s 晚 6–60 秒。

結果歌曲的完整歌詞。replace-section 必填。

分軌名稱。advanced-split 必填。

要續接的前一個片段 ID。

續寫起點，單位為秒。upload-extend 必填且必須大於 0。

用於輪詢狀態的任務 ID。

同一個非同步任務 ID 的別名，僅在回傳時存在。

可用時返回的優先輪詢 URL。

任務狀態：pending、processing、completed 或 failed。

任務建立的 Unix 時間戳記，僅在回傳時存在。