Suno
查询单个任务
DeerAPI 查询单个任务接口：通过 GET /suno/fetch/ 轮询获取 Suno 音乐/歌词生成等异步任务状态与结果，返回音频URL、clip_id、元数据。
GET
/
suno
/
fetch
/
{task_id}
查询单个任务
Copy
curl --request GET \
--url https://api.deerapi.com/suno/fetch/{task_id} \
--header 'Authorization: Bearer <token>'Copy
{
"code": "<string>",
"message": "<string>",
"data": {
"task_id": "<string>",
"action": "<string>",
"status": "<string>",
"fail_reason": "<string>",
"submit_time": 123,
"start_time": 123,
"finish_time": 123,
"progress": "<string>",
"data": null
}
}单任务查询
/suno/fetch/\{task_id\} 接口允许您检索特定任务的详细状态和结果。这是跟踪进度和获取异步操作结果的主要接口，例如音乐生成、歌词创建、音频上传和拼接任务。
使用此接口监控任务完成情况并检索生成的内容，包括音频 URL、片段 ID、元数据和其他特定于任务的数据。
典型工作流程
音乐生成：- 通过生成音乐片段提交音乐生成请求
- 在响应中接收
task_id - 使用
task_id轮询此接口，直到状态变为"SUCCESS" - 从
data字段中提取生成的音乐 URL 和clip_id - 将
clip_id用于后续操作，如续写、拼接，或获取 MP4 视频和时间轴数据
- 通过生成歌词提交歌词生成请求
- 在响应中接收
task_id - 使用
task_id轮询此接口，直到状态变为"SUCCESS" - 从
data字段中提取生成的歌词文本 - 将歌词与生成音乐片段接口一起使用，创建完整的歌曲
Authorizations
Bearer token authentication. Use your DeerAPI key.
Path Parameters
任务ID，可在生成音乐响应中查看
⌘I
查询单个任务
Copy
curl --request GET \
--url https://api.deerapi.com/suno/fetch/{task_id} \
--header 'Authorization: Bearer <token>'Copy
{
"code": "<string>",
"message": "<string>",
"data": {
"task_id": "<string>",
"action": "<string>",
"status": "<string>",
"fail_reason": "<string>",
"submit_time": 123,
"start_time": 123,
"finish_time": 123,
"progress": "<string>",
"data": null
}
}