按 ID 查询音乐任务
音乐生成任务格式
按 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": "轻快电子流行,夏日海边,女声 旋律"
}
}
]
}
}
GET
按 ID 查询音乐任务
