Recovery Audio
Document updated
If you have already completed the integration process previously, you can still access the old version document at: Old version address (https://docs.kie.ai/old-model/suno-api/recovery-audio)
Recover playable audio links for a music generation task that has already completed.
Suno's original links (source_audio_url) are only valid for a limited period of time and are deprecated. Submit the task_id of the original music generation task and every track of that task will be recovered together.
Submit with POST /api/v1/suno/recovery {"taskId": ""} and poll GET /api/v1/suno/recovery/record-info.
Query Task Status
This task is NOT queried through the generic Get Task Details endpoint. Use the dedicated polling endpoint below, with the recovery task_id returned by this endpoint:
GET /api/v1/suno/recovery/record-info?task_id={task_id}
Polling rules:
- A 2 second interval is recommended.
code= 201 means the task is still running (dataisnull) — keep polling.code= 200 means the recovery finished anddatacarries one entry per track — stop polling.code= 500 means every track failed to recover — stop polling.
TIP
In the production environment, it is recommended to use the callBackUrl parameter to receive the automatic notification upon completion, rather than polling the status endpoint.
Callback
When callBackUrl is provided, a POST request is sent to it once the recovery task finishes. The task level code is 200 when at least one track was recovered, and 500 when all of them failed.
Request
Responses
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://pale-vibraphone.com/",
"input": {
"task_id": "25"
}
}'{
"code": 200,
"msg": "success",
"data": {
"taskId": "dc1928bfcbc77cb6c85f3359a9c718b3"
}
}