KIE.AI
old-model
  • All Model
  • old-model
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
old-model
  • All Model
  • old-model
old-model
  • All Model
  • old-model
Suno API
4o Image APIVeo3.1 APIRunway APIFlux Kontext API
Suno API
4o Image APIVeo3.1 APIRunway APIFlux Kontext API
  1. Music Generation
  • Suno API Quickstart
  • Music Generation
    • Music Cover Generation Callbacks
    • Music Generation Callbacks
    • Music Extension Callbacks
    • Audio Upload and Cover Callbacks
    • Audio Upload and Extension Callbacks
    • Add Instrumental Callbacks
    • Add Vocals Callbacks
    • Replace Music Section Callbacks
    • Generate Music
      POST
    • Extend Music
      POST
    • Upload And Cover Audio
      POST
    • Upload And Extend Audio
      POST
    • Add Instrumental to Music
      POST
    • Add Vocals to Music
      POST
    • Get Music Task Details
      GET
    • Get Timestamped Lyrics
      POST
    • Boost Music Style
      POST
    • Generate Music Cover
      POST
    • Get Cover Generation Details
      GET
    • Replace Music Section
      POST
    • Generate Persona
      POST
    • Generate Mashup Music
      POST
    • Recovery Audio
      POST
  • Lyrics Generation
    • Lyrics Generation Callbacks
    • Generate Lyrics
      POST
    • Get Lyrics Task Details
      GET
  • WAV Conversion
    • Convert to WAV Callbacks
    • Convert to WAV Format
    • Get WAV Conversion Details
  • Vocal Removal
    • Audio Separation Callbacks
    • MIDI Generation Callbacks
    • Vocal & Instrument Stem Separation
    • Get Vocal Separation Details
    • Generate MIDI from Audio
    • Get MIDI Generation Details
  • Music Video Generation
    • Music Video Generation Callbacks
    • Create Music Video
    • Get Music Video Details
  • Sounds Generation
    • Generate sounds
  • voice
    • Suno Voice Generation Callback
    • Suno Voice Validation Phrase Callback
    • Suno Voice Generate Verification Phrase API
    • Suno Voice Get Verification Phrase API
    • Suno Voice Create Custom Voice API
    • Suno Voice Get Custom Voice Records
    • Suno Voice Regenerate Verification Phrase
    • Suno Voice Check Availability API
  1. Music Generation

Recovery Audio

POST
/api/v1/suno/recovery
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.
This endpoint only creates the task: it returns a recovery task_id immediately and the recovery itself runs asynchronously.

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 (data is null) — keep polling.
code = 200 means the recovery finished and data carries one entry per track — stop polling.
code = 500 means every track failed to recover — stop polling.
In the production environment, it is recommended to use the call_back_url parameter to receive the automatic notification upon completion, rather than polling the status endpoint.

Callback#

When call_back_url 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. The body has the same shape as the response of GET /api/v1/suno/recovery/record-info.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Request successful
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
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"
}'
Response Response Example
{
    "code": 200,
    "msg": "success",
    "data": {
        "task_id": "dc1928bfcbc77cb6c85f3359a9c718b3"
    }
}
Previous
Generate Mashup Music
Next
Lyrics Generation Callbacks
Built with