Recovery Audio
Generate Music
Recovery Audio
Recover playable audio links for an existing music generation task.
POST
Recovery Audio
Used to recover playable audio links for a music generation task that has already completed. Submit the
The task level
sunoTaskId of the original task and the service regenerates accessible audio URLs for every track that belongs to it.
🚀 User Guide
- Suno’s original links are only valid for a limited period of time. Once they expire, the audio can no longer be played or downloaded from those URLs.
- Submit the
sunoTaskIdof the original music generation task — all tracks of that task are recovered together. - This endpoint only creates the task: it returns a recovery
task_idimmediately and the recovery itself runs asynchronously. - The result is pushed to
callBackUrlwhen the task finishes, and can also be read by polling Get Recovery Audio Details.
📌 Usage Scenarios
- 🔗 Restoring playback for songs that were generated a long time ago
- 📦 Refreshing audio links before archiving or migrating your own library
- 🛠️ Repairing broken audio URLs reported by your end users
⚠️ Notes
sunoTaskIdin the request body is the music generation task ID (for example the one returned by Generate Music), not the ID returned by this endpoint.- The
task_idin the response is the recovery task ID and is only accepted by Get Recovery Audio Details. callBackUrlis required. The recovery result is pushed to it once the task finishes.- Creating the task successfully does not guarantee that every track can be recovered — check the final result for the per-track
status.
📩 Callback
Once the recovery task finishes, aPOST request is sent to callBackUrl:
code is 200 when at least one track was recovered, and 500 when all of them failed. The order of data matches the tracks of the original task.Authorizations
🔑 API Authentication
All endpoints require authentication using Bearer Token.
Get API Key
- Visit the API Key Management Page to obtain your API Key
Usage
Add to request headers:
⚠️ Note:
- Keep your API Key secure and do not share it with others
- If you suspect your API Key has been compromised, reset it immediately from the management page
Body
application/json
The task ID of the original music generation task whose audio links need to be recovered.
Example:
"5c79****be8e"
Callback URL notified when the recovery task finishes. The recovery result is pushed to this address.
Example:
"https://api.example.com/callback"
Response
Request successful
Status Codes
- ✅ 200 - Request successful
- ⚠️ 400 - Invalid parameters
- ⚠️ 401 - Unauthorized access
- ⚠️ 404 - Invalid request method or path
- ⚠️ 405 - Rate limit exceeded
- ⚠️ 413 - Theme or prompt too long
- ⚠️ 429 - Insufficient credits
- ⚠️ 430 - Your call frequency is too high. Please try again later.
- ⚠️ 455 - System maintenance
- ❌ 500 - Server error
Available options:
200, 400, 401, 404, 405, 413, 429, 430, 455, 500 Example:
200
Error message when code != 200
Example:
"success"
