Skip to main content
GET
/
config
/
tts-voice-preview
Stream Voice Preview
curl --request GET \
  --url https://voice-livekit.studio.lyzr.ai/v1/config/tts-voice-preview \
  --header 'x-api-key: <api-key>'
"<string>"
Stream a short audio sample of a specific voice directly from the TTS provider. When users are building Voice Agents, reading that a voice is “warm and energetic” often isn’t enough—they need to hear it. This endpoint proxies the audio preview from providers like ElevenLabs or Cartesia so you can play it directly in your application’s UI.
Authentication Required: You must include your API key in the x-api-key header to authenticate this request.

​
Required Parameters

You must provide two query parameters to successfully fetch the audio:
  1. providerId: The ID of the provider hosting the voice (e.g., elevenlabs, cartesia).
  2. url: The exact URL of the preview audio file. You can find this URL inside the previewUrl field when querying the List Provider Voices endpoint.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
providerId
enum<string>
required

The internal ID of the TTS provider hosting the voice.

Available options:
cartesia,
elevenlabs,
deepgram,
inworld,
rime,
sarvam
Example:

"elevenlabs"

​
url
string<uri>
required

The specific preview URL for the voice (typically obtained from the tts-voices or realtime-options endpoints).

Example:

"https://example.com/audio/voice_sample.wav"

Response

Audio bytes streamed successfully with the provider's content-type.

The raw binary audio stream of the voice preview.