跳转到主要内容
GET
/
suno
/
v2
/
status
get task status
curl --request GET \
  --url https://api.mountsea.ai/suno/v2/status \
  --header 'Authorization: Bearer <token>'
{
  "taskId": "task_1731a9b2f4",
  "status": "queued",
  "createdAt": "2025-08-18T02:30:00.000Z",
  "failReason": "Audio source not found.",
  "failCode": 4001,
  "data": {},
  "finishAt": "2025-08-18T02:35:00.000Z"
}
所有异步端点（generate、lyrics、mashupLyrics、concat、remaster、mp4、wav 等）都会返回一个 taskId。使用此端点轮询任务，直到其达到终态（success、failed 或 timeout）。

​
任务状态值

状态描述
ready任务已排队，等待处理
running任务正在处理中
stream任务正在流式返回部分结果
success任务已成功完成 — 请查看 data 获取结果
failed任务失败 — 请查看 failReason 和 failCode
timeout任务超时

​
轮询最佳实践

轮询时使用指数退避策略：从 2-3 秒间隔开始，然后逐渐增加。音乐生成任务通常需要 30-120 秒，具体取决于任务类型。

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

​
taskId
string
必填

Task ID

示例:

"1212"

响应

200 - application/json

The task status information

​
taskId
string
必填

Task id.

示例:

"task_1731a9b2f4"

​
status
enum<string>
必填

task status

可用选项:
queued,
ready,
running,
stream,
awaiting,
success,
failed,
timeout
​
createdAt
string<date-time>
必填

Task created time (UTC).

示例:

"2025-08-18T02:30:00.000Z"

​
failReason
string

Failure reason when status=FAILED.

示例:

"Audio source not found."

​
failCode
number

Failure code when status=FAILED.

示例:

4001

​
data
object

Data associated with the task.

​
finishAt
string<date-time>

Task finished time (UTC).

示例:

"2025-08-18T02:35:00.000Z"