依 ID 查詢音樂任務

透過 path task_id 查詢音樂生成任務。

音樂生成任務查詢介面。建立介面返回的 data 即任務 ID，透過 GET /suno/fetch/{task_id} 查詢單個任務。

查詢方式

GET /suno/fetch/task_xxx

查詢輸出

外層保持 new-api 任務結構：

• code：成功時為 success。
• message：錯誤或提示資訊。
• data.task_id：任務 ID。
• data.status：任務狀態，常見值 NOT_START、SUBMITTED、QUEUED、IN_PROGRESS、SUCCESS、FAILURE。
• data.progress：任務進度。
• data.result_url：成功後可用的結果位址，若上游返回多首歌曲，以 data.data 內片段為準。
• data.data：上游音樂結果原始資料，通常包含歌曲片段陣列或物件。

成功態範例：

{
 "code": "success",
 "message": "",
 "data": {
 "task_id": "task_xxx",
 "platform": "suno",
 "action": "MUSIC",
 "status": "SUCCESS",
 "progress": "100%",
 "result_url": "https://example.com/audio.mp3",
 "properties": {
 "upstream_model_name": "suno_music",
 "origin_model_name": "suno-v5"
 },
 "data": [
 {
 "id": "clip_xxx",
 "title": "夏日海风",
 "audio_url": "https://example.com/audio.mp3",
 "image_url": "https://example.com/cover.jpg",
 "model_name": "suno-v5",
 "metadata": {
 "duration": 180,
 "prompt": "轻快电子流行，夏日海边，女声 旋律"
 }
 }
 ]
 }
}