> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountsea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取任务状态

> 查询任何异步任务的状态和结果

<Info>
  所有异步端点（generate、lyrics、mashupLyrics、concat、remaster、mp4、wav 等）都会返回一个 `taskId`。使用此端点轮询任务，直到其达到终态（`success`、`failed` 或 `timeout`）。
</Info>

## 任务状态值

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

## 轮询最佳实践

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


## OpenAPI

````yaml GET /suno/v2/status
openapi: 3.0.0
info:
  title: Suno AI
  description: API documentation for Suno AI
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.mountsea.ai
    description: API Gateway
security: []
tags:
  - name: suno
    description: ''
paths:
  /suno/v2/status:
    get:
      tags:
        - suno
      summary: get task status
      description: get task status, you can get the task status by taskId
      operationId: ApiPublicController_getTaskStatus
      parameters:
        - name: taskId
          required: true
          in: query
          description: Task ID
          schema:
            example: '1212'
            type: string
      responses:
        '200':
          description: The task status information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTaskStatusResDto'
      security:
        - bearerAuth: []
components:
  schemas:
    GetTaskStatusResDto:
      type: object
      properties:
        taskId:
          type: string
          description: Task id.
          example: task_1731a9b2f4
        status:
          enum:
            - queued
            - ready
            - running
            - stream
            - awaiting
            - success
            - failed
            - timeout
          type: string
          description: task status
        failReason:
          type: string
          description: Failure reason when status=FAILED.
          example: Audio source not found.
        failCode:
          type: number
          description: Failure code when status=FAILED.
          example: 4001
        data:
          type: object
          description: Data associated with the task.
        finishAt:
          type: string
          description: Task finished time (UTC).
          example: '2025-08-18T02:35:00.000Z'
          format: date-time
        createdAt:
          type: string
          description: Task created time (UTC).
          example: '2025-08-18T02:30:00.000Z'
          format: date-time
      required:
        - taskId
        - status
        - createdAt
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````