Skip to main content

​
GET /music/task/:taskId

查询音乐生成任务的当前状态和详细信息。

​
认证

需要 Bearer Token。

​
路径参数

参数类型说明
taskIdstring任务 UUID

​
响应

{
  "taskId": "abc-123",
  "status": "completed",
  "title": "My Song",
  "lyrics": "[Verse]\nHello world...",
  "prompt": "upbeat pop",
  "audioId": "user123/thread456/music_abc.mp3",
  "coverId": "user123/thread456/mc_abc.jpg",
  "coverWidth": 1024,
  "coverHeight": 1024,
  "durationMs": 180000,
  "audioUrl": "https://...",
  "coverUrl": "https://...",
  "errorMessage": null,
  "createdAt": "2026-03-05T10:00:00Z"
}

​
状态说明

状态说明
pending任务已创建，等待 Worker 处理
processingWorker 正在生成音乐
completed音乐生成成功，audioUrl 和 coverUrl 可用
failed生成失败，errorMessage 记录原因
insufficient_creditsCredits 不足，用户充值后可重新提交
audioUrl 和 coverUrl 为 Signed URL，仅在 status === "completed" 时返回。