Skip to main content
POST
/
audio
/
retrieve
/api/v1/audio/retrieve
curl --request POST \
  --url https://api.venice.ai/api/v1/audio/retrieve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "elevenlabs-music",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000",
  "delete_media_on_completion": false
}
'
{
  "status": "PROCESSING",
  "average_execution_time": 20000,
  "execution_duration": 5200
}
Use the queue_id returned by /audio/queue to check generation status. When the request completes, this endpoint returns the generated audio data.

​
Postman Collection

For additional examples, please see this Postman Collection.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
model
string
required

The ID of the model used for audio generation.

Example:

"elevenlabs-music"

​
queue_id
string
required

The ID of the audio generation request. Use this to poll for status and retrieve the result.

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
delete_media_on_completion
boolean
default:false

If true, the audio media will be deleted from storage after the request is completed. If false, you can use the complete endpoint to remove the media once you have successfully downloaded the audio.

Example:

false

Response

Audio generation status or completed audio

​
status
enum<string>
required

The status of the audio generation request.

Available options:
PROCESSING
Example:

"PROCESSING"

​
average_execution_time
number
required

The estimated execution time of the audio generation request in milliseconds (P80).

Example:

20000

​
execution_duration
number
required

The current duration of the audio generation request in milliseconds.

Example:

5200