Skip to content
RevoxRevox
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", "gradium"]

The provider to use for the preview.

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

The voice ID to generate a preview for.

model: Optional[Literal["sonic-3", "sonic-3.5", "sonic-3.6"]]

Cartesia model for the preview. Defaults to sonic-3.6. Ignored for other providers.

One of the following:
"sonic-3"
"sonic-3.5"
"sonic-3.6"
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