查詢任務
依任務 ID 查詢 Suno MJ 任務狀態與結果。不同任務類型會回傳不同的結果欄位。
使用提交 API 回傳的任務 ID 查詢任務狀態與結果。
任務 ID 與音軌 ID
| 識別碼 | 用途 |
|---|---|
jobId / job_id | 任務 ID，用於查詢狀態與結果；依對應提交 API 的實際回應讀取。 |
music_id / musicId | 音軌 ID，用於翻唱、續寫、加入人聲或加入伴奏。 |
上傳參考音訊支援同步與非同步兩種方式。同步成功會直接回傳音軌 ID；非同步上傳完成後，音軌 ID 位於查詢回應的 data.data.data.musics[].musicId。不要將音軌 ID 當作任務 ID 查詢。多個任務可使用批次查詢任務。
狀態與結果
| 狀態 | 意義 |
|---|---|
NOT_START | 任務已建立，尚未開始處理。 |
QUEUED | 任務正在佇列中等候。 |
ON_QUEUE | 佇列等候中。 |
SUCCESS | 任務成功，讀取對應類型的結果。 |
FAILED | 任務失敗，檢視任務回傳的錯誤資訊。 |
提交回應中的 status: SUCCESS 表示請求受理成功，不代表非同步任務已經完成。查詢回應最外層的 code: success 表示查詢請求成功；任務狀態讀取 data.status。音樂生成或非同步上傳任務完成後，音軌位於 data.data.data.musics[]。其中每筆音軌的 musicId 用於後續操作，audioUrl 指向音訊；沒有標題時，title 可能為 null。其他任務類型的結果欄位可能不同，無法直接套用此結構。
回呼通知
提交請求時可選填 hookUrl，接收平台轉送的任務通知。回呼網址只支援 80、443、8080 和 8443 連接埠。
未填寫 hookUrl 時，可主動查詢任務；狀態更新可能有延遲。填寫回呼後仍可使用查詢 API 取得結果。回呼設定以提交請求中的 hookUrl 為準，不要使用查詢回應中的 data.hookUrl 判斷回呼網址。