API Reference

Voices

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Generate voice preview

voices.preview(VoicePreviewParams**kwargs)

POST/voices/preview

Generate a short audio preview for a given voice. Provide the voice ID and provider, and the API returns an audio/mpeg stream you can play back to hear how the voice sounds before assigning it to an assistant.

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.

Generate voice preview

Python

HTTP

TypeScript

Python

Ruby

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