Audio

/api/v1/audio/voice-changer/retrieve

Poll a queued voice conversion. While the conversion is still running this returns status: "PROCESSING" as JSON; once it finishes it returns the converted audio bytes.

A completed response carries the audio alongside x-venice-audio-format, x-venice-audio-duration, x-venice-inference-time, x-venice-model-id and x-venice-model-name.

Only the account that queued a conversion can poll it. Any other queue_id — unknown, belonging to someone else, malformed, or older than the retrieve window — is reported the same way, as an invalid request id.

If the provider fails the conversion, the charge is refunded automatically and the response reports whether that refund succeeded in credits_refunded. The outcome is recorded, so polling again replays the same result rather than refunding twice.

When credits_refunded is false and the conversion was charged, the error message says what to do about it: a refund that was attempted and did not go through asks you to contact support and is retried by polling again, and a request id the provider no longer recognises is reported as too weak a verdict to reverse a charge on. A conversion that was never charged, or one already delivered, reports false with nothing further.

Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.

post/api/v1/audio/voice-changer/retrieve

Request

  • Base URL: https://api.venice.ai
  • URL: https://api.venice.ai/api/v1/audio/voice-changer/retrieve
  • Auth: one of:
    • HTTP bearer
    • API key in header SIGN-IN-WITH-X

Request body

modelstring required

The model that is running the conversion. Only voice-changer models are accepted on the /api/v1/audio/voice-changer endpoints.

queue_idstring required

Pass this to /audio/voice-changer/retrieve to poll for the converted audio, and to /audio/voice-changer/complete when finished.

delete_media_on_completionboolean

Release the provider-held media as soon as this call returns the audio, so a separate /audio/voice-changer/complete call is unnecessary. The audio cannot be retrieved again afterwards.

Example request

{
  "model": "elevenlabs-voice-changer",
  "queue_id": "0190f2c4-9c1e-7a3b-8f42-2c9d5e7a1b34"
}

Response

Conversion still processing, or the completed audio

status'PROCESSING' required

The conversion is still running. Poll again.

average_execution_timenumber required

Recent average end-to-end time for this model in milliseconds. Use it to pace polling.

execution_durationnumber required

Milliseconds elapsed since the conversion was queued.

Example response

{
  "status": "PROCESSING",
  "average_execution_time": 10000,
  "execution_duration": 4200
}

Changes

No recorded changes to this operation across all 1 revision of this API.