Complete Audio

Mark an audio generation request as complete and clean up the generated media from storage. Call this after you have successfully downloaded the audio if you did not set delete_media_on_completion in the retrieve request.

Authentication: This endpoint accepts either a Bearer API key or an X-Sign-In-With-X header for x402 wallet-based authentication. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.

POST /audio/complete

/api/v1/audio/complete

cURL

curl --request POST \
  --url https://api.venice.ai/api/v1/audio/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "elevenlabs-music",
  "queue_id": "123e4567-e89b-12d3-a456-426614174000"
}
'

200

{
  "success": true
}

Call this endpoint after you have successfully downloaded generated audio when you want Venice to clean up stored media associated with the request.

Postman Collection

For additional examples, please see this Postman Collection.

---

Authorizations

BearerAuthsiwx

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"

Response

200

application/json

Media cleanup result. A success value of false indicates cleanup did not complete and can be retried later.

success · boolean · required

Indicates whether the audio cleanup was successful.

Example:

true