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

# 获取恢复音频详情

> 查询恢复任务的状态与恢复出的音频链接。

查询由[恢复音频](/cn/suno-api/recovery-audio)接口创建的恢复任务，读取恢复出的音频链接。

### 状态说明

* `201` — 恢复任务进行中，请继续轮询
* `200` — 恢复完成，且至少有一首音轨恢复成功
* `500` — 所有音轨均恢复失败

### 单条记录的 `status`

* `success` — `audio_url` 为恢复出的可播放链接
* `failed` — `audio_url` 为空，`error` 说明失败原因

常见的 `error` 取值：

| 取值                      | 含义          |
| ----------------------- | ----------- |
| `no_audio_id_mappings`  | 该任务下找不到对应音轨 |
| `account_missing`       | 来源账号不可用     |
| `get_tokens_failed`     | 上游服务鉴权失败    |
| `feed_failed`           | 从上游服务查询音轨失败 |
| `clip_error`            | 上游音轨处于异常状态  |
| `clip_not_complete`     | 上游音轨尚未生成完成  |
| `mango_transfer_failed` | 恢复出的文件转存失败  |

### 开发者提示

* 无法提供公网回调地址时请轮询本接口，建议轮询间隔 2 秒。
* `code` 为 `201` 时 `data` 为 `null`。
* 恢复出的 `audio_url` 可能是 `.m4a` 文件，保存时不要固定按 `.mp3` 处理。


## OpenAPI

````yaml cn/suno-api/suno-api-cn.json GET /api/v1/suno/recovery/record-info
openapi: 3.0.0
info:
  title: intro
  description: 这是生成音频的API接口文档
  version: 1.0.0
  contact:
    name: 技术支持
    email: support@api.box
servers:
  - url: https://apibox.erweima.ai
    description: API 服务器
security:
  - BearerAuth: []
tags:
  - name: Music Generation
    description: 用于创建和管理音乐生成任务的接口
  - name: Lyrics Generation
    description: 用于歌词生成和管理的接口
  - name: WAV Conversion
    description: 用于将音乐转换为WAV格式的接口
  - name: Vocal Removal
    description: 用于从音乐轨道中移除人声的接口
  - name: Music Video Generation
    description: 用于生成MP4视频的接口
  - name: Account Management
    description: 用于账户和积分管理的接口
  - name: Audio Enhancement
    description: 用于增强和修改现有音频的伴奏和人声元素的接口
paths:
  /api/v1/suno/recovery/record-info:
    get:
      summary: 获取恢复音频详情
      description: |-
        查询恢复任务的状态与恢复出的音频链接。

        ## 使用指南
        - `code` 为 201 表示任务仍在进行中，请继续轮询（建议间隔 2 秒）。
        - `code` 为 200 表示恢复完成，`data` 中每一项对应一首音轨。
        - `code` 为 500 表示所有音轨均恢复失败。
      operationId: get-recovery-audio-details
      parameters:
        - in: query
          name: task_id
          description: 「恢复音频」接口返回的恢复任务 ID。
          required: true
          example: dc19****18b3
          schema:
            type: string
      responses:
        '200':
          description: 请求成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    enum:
                      - 200
                      - 201
                      - 400
                      - 401
                      - 404
                      - 405
                      - 429
                      - 430
                      - 455
                      - 500
                    description: |-
                      # 状态码说明

                      - ✅ 200 - 恢复完成，至少有一首音频恢复成功
                      - ⏳ 201 - 恢复任务进行中，请继续轮询
                      - ⚠️ 400 - 参数错误
                      - ⚠️ 401 - 没有访问权限
                      - ⚠️ 404 - 请求方式或者路径错误
                      - ⚠️ 405 - 调用超过限制
                      - ⚠️ 429 - 积分不足
                      - ⚠️ 430 - 您的调用频率过高。请稍后再试。
                      - ⚠️ 455 - 网站维护
                      - ❌ 500 - 恢复任务失败或服务器异常
                    example: 200
                  task_id:
                    type: string
                    description: 恢复任务 ID。
                    example: bbbb****0f7b
                  msg:
                    type: string
                    description: 结果描述
                    example: success
                  data:
                    type: array
                    nullable: true
                    description: 每首音轨的恢复结果，任务进行中时返回 `null`。
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: 音轨 ID，与原音乐生成任务中的音频 ID 一致。
                          example: f8d6****9b93
                        audio_url:
                          type: string
                          description: 恢复后的可播放音频链接，仅在 `status` 为 `success` 时返回。
                          example: https://example.com/****.m4a
                        title:
                          type: string
                          description: 音轨标题，仅在 `status` 为 `success` 时返回。
                          example: Sunrise Love
                        status:
                          type: string
                          enum:
                            - success
                            - failed
                          description: 该音轨的恢复结果。
                          example: success
                        error:
                          type: string
                          description: 失败原因，`status` 为 `success` 时为空。
                          example: ''
        '500':
          $ref: '#/components/responses/Error'
components:
  responses:
    Error:
      description: 服务器异常
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: |-
        # 🔑 API 认证说明

        所有接口都需要通过 Bearer Token 方式进行认证。

        ## 获取 API Key

        1. 访问 [API Key 管理页面](https://api.box/api-key) 获取您的 API Key

        ## 使用方式

        在请求头中添加：

        ```
        Authorization: Bearer YOUR_API_KEY
        ```

        > **⚠️ 注意：**
        > - 请妥善保管您的 API Key，不要泄露给他人
        > - 如果怀疑 API Key 泄露，请立即在管理页面重置

````