Skip to main content
GET
https://api.revocalize.ai
/
check-task
/
{task_id}
curl --location --request GET 'https://api.revocalize.ai/check-task/12345'
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'

{
  "status": "completed",
  "input_audio_url": "https://cdn.revocalize.ai/12345/input.wav",
  "output_audio_urls": [
    "https://cdn.revocalize.ai/12345/output.wav"
  ],
  "output_settings": [
    "model": "andra"
    "transpose": -3,
    "vocal_style": "melodic"
  ]
}

​
Request

​
task_id
string
required
The task ID for the task you want to check the status of. This is generated in the response of the /convert endpoint.

​
Response

​
status
string
Indicates the status of the task. Possible values are completed, in_progress, and failed.
​
input_audio_url
string
The URL of the input audio file that was submitted for conversion.
​
output_audio_urls
array
An array with URLs for the converted vocal audio files, if the conversion was successful. Unless the generations_count parameter was set higher than 1, in the convert audio file request, this array will only contain one URL.
​
output_settings
object
The output settings used for the conversion task. This object contains the following properties:
curl --location --request GET 'https://api.revocalize.ai/check-task/12345'
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'

{
  "status": "completed",
  "input_audio_url": "https://cdn.revocalize.ai/12345/input.wav",
  "output_audio_urls": [
    "https://cdn.revocalize.ai/12345/output.wav"
  ],
  "output_settings": [
    "model": "andra"
    "transpose": -3,
    "vocal_style": "melodic"
  ]
}