恢复音频

为已经生成完成的音乐任务恢复可播放的音频链接。

Suno 的原始链接（source_audio_url）只在一段时间内有效，现已废弃。传入原音乐生成任务的 task_id，该任务下的所有音轨会一起恢复。

本接口只负责创建任务：立即返回恢复任务的 task_id，实际恢复过程为异步执行。

查询任务状态

**本任务不能通过通用的「获取任务详情」接口查询。**请使用下面这个专用的轮询接口，并传入本接口返回的恢复任务 task_id：

GET /api/v1/suno/recovery/record-info?task_id={task_id}

轮询规则：

建议轮询间隔 2 秒。

code 为 201 表示任务仍在执行中（data 为 null），请继续轮询。

code 为 200 表示恢复完成，data 中每一项对应一首音轨，停止轮询。

code 为 500 表示所有音轨均恢复失败，停止轮询。

在生产环境中，建议使用 call_back_url 参数在恢复完成后接收自动通知，而非轮询状态接口。

回调说明

传入 call_back_url 时，恢复任务结束后会向该地址发起 POST 请求。任务级 code 为 200 表示至少有一首音轨恢复成功，为 500 表示全部失败。回调报文结构与 GET /api/v1/suno/recovery/record-info 的响应一致。

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.kie.ai/api/v1/suno/recovery' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "task_id": "5c79bea4b7e14dd8a1c0e2a1f1f0be8e", "call_back_url": "https://api.example.com/callback" }'

查询任务状态

回调说明

Request

Responses

恢复音频

查询任务状态#

回调说明#

Request

Responses

查询任务状态

回调说明