查询单个任务

单任务查询

/suno/fetch/{task_id} 接口允许您检索特定任务的详细状态和结果。这是跟踪进度和获取异步操作结果的主要接口，例如音乐生成、歌词创建、音频上传和拼接任务。

使用此接口监控任务完成情况并检索生成的内容，包括音频 URL、片段 ID、元数据和其他特定于任务的数据。

典型工作流程

音乐生成：

通过生成音乐片段提交音乐生成请求

在响应中接收 task_id

使用 task_id 轮询此接口，直到状态变为 "SUCCESS"

从 data 字段中提取生成的音乐 URL 和 clip_id

将 clip_id 用于后续操作，如续写、拼接，或获取 MP4 视频和时间轴数据

歌词生成：

通过生成歌词提交歌词生成请求

在响应中接收 task_id

使用 task_id 轮询此接口，直到状态变为 "SUCCESS"

从 data 字段中提取生成的歌词文本

将歌词与生成音乐片段接口一起使用，创建完整的歌曲

{ "code": "success", "message": "", "data": { "task_id": "dcb812bd-40c5-4907-836e-3a7aa9a2e546", "action": "MUSIC", "status": "NOT_START", "fail_reason": "", "submit_time": 1747203819, "start_time": 1747203819, "finish_time": 0, "progress": "0%", "data": null } }

单任务查询

典型工作流程

请求参数

返回响应

查询单个任务

单任务查询#

典型工作流程#

请求参数

返回响应

单任务查询

典型工作流程