Skip to content
revox
Get started
API Reference
Voices

Generate voice preview

client.voices.preview(VoicePreviewParams { provider, voiceId, speed, 2 more } body, RequestOptionsoptions?): void
POST/voices/preview

Generate a short audio preview for a given voice.

ParametersExpand Collapse
body: VoicePreviewParams { provider, voiceId, speed, 2 more }
provider: "cartesia" | "elevenlabs"

The provider to use for the preview.

One of the following:
"cartesia"
"elevenlabs"
voiceId: string

The voice ID to generate a preview for.

speed?: number

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

minimum0.6
maximum1.5
text?: string

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

maxLength2000
volume?: number

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

minimum0.5
maximum2

Generate voice preview

import Revox from '@revoxai/sdk';

const client = new Revox({
  apiKey: process.env['REVOX_API_KEY'], // This is the default and can be omitted
});

await client.voices.preview({ provider: 'cartesia', voiceId: 'voiceId' });
Returns Examples