Get Recovery Audio Details
Generate Music
Get Recovery Audio Details
Query the status and recovered audio links of a recovery task.
GET
Get Recovery Audio Details
Query a recovery task created by Recovery Audio and read the recovered audio links.
Per-track
Status Descriptions
201— the recovery task is still running, keep polling200— the recovery finished and at least one track was recovered successfully500— every track failed to recover
Per-track status
success—audio_urlcarries the recovered playable linkfailed—audio_urlis empty anderrorexplains the reason
error values:
Developer Notes
- Poll this endpoint instead of waiting for the callback when you cannot expose a public callback URL. A 2 second interval is recommended.
dataisnullwhilecodeis201.- A recovered
audio_urlmay be an.m4afile — do not assume.mp3when saving it.
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
Query Parameters
The recovery task ID returned by the Recovery Audio endpoint.
Response
Request successful
Status Codes
- ✅ 200 - Recovery finished, at least one track recovered successfully
- ⏳ 201 - Recovery task is still running, keep polling
- ⚠️ 400 - Invalid parameters
- ⚠️ 401 - Unauthorized access
- ⚠️ 404 - Invalid request method or path
- ⚠️ 405 - Rate limit exceeded
- ⚠️ 429 - Insufficient credits
- ⚠️ 430 - Your call frequency is too high. Please try again later.
- ⚠️ 455 - System maintenance
- ❌ 500 - Recovery task failed or server error
Available options:
200, 201, 400, 401, 404, 405, 429, 430, 455, 500 Example:
200
Recovery task ID.
Example:
"bbbb****0f7b"
Result message
Example:
"success"
Recovery result of each track. Returns null while the task is still running.
