Skip to content
revox
Get started
API Reference
Voices

Generate voice preview

voices.preview(VoicePreviewParams**kwargs)
POST/voices/preview

Generate a short audio preview for a given voice.

ParametersExpand Collapse
provider: Literal["cartesia", "elevenlabs"]

The provider to use for the preview.

One of the following:
"cartesia"
"elevenlabs"
voice_id: str

The voice ID to generate a preview for.

speed: Optional[float]

Speed for preview. Cartesia 0.6–1.5, ElevenLabs 0.7–1.2. Default 1.0.

minimum0.6
maximum1.5
text: Optional[str]

Custom text for the preview. If omitted, a short default is used.

maxLength2000
volume: Optional[float]

Volume for Cartesia preview (0.5–2.0). Ignored for other providers.

minimum0.5
maximum2

Generate voice preview

import os
from revox import Revox

client = Revox(
    api_key=os.environ.get("REVOX_API_KEY"),  # This is the default and can be omitted
)
client.voices.preview(
    provider="cartesia",
    voice_id="voiceId",
)
Returns Examples