恢复音频

文档已更新

若你此前已完成对接，仍可前往旧版文档查看：旧版地址 (https://docs.kie.ai/old-model/cn/suno-api/recovery-audio)

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

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 表示所有音轨均恢复失败，停止轮询。

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

回调说明

传入 callBackUrl 时，恢复任务结束后会向该地址发起 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/jobs/createTask' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "ai-music-api/suno-recovery-audio", "callBackUrl": "https://api.example.com/callback", "input": { "task_id": "73d6128b3523a0079df10da9471017c8" } }'

查询任务状态

回调说明

Request

Responses

恢复音频

查询任务状态#

回调说明#

Request

Responses

查询任务状态

回调说明