API Reference

Voices

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Generate voice preview

voices.preview(**kwargs) -> void

POST/voices/preview

Generate a short audio preview for a given voice.

ParametersExpand Collapse

provider: :cartesia | :elevenlabs

The provider to use for the preview.

One of the following:

:cartesia

:elevenlabs

voice_id: String

The voice ID to generate a preview for.

speed: Float

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: Float

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

minimum0.5

maximum2

Generate voice preview

Ruby

HTTP

TypeScript

Python

Ruby

require "revox"

revox = Revox::Client.new(api_key: "My API Key")

result = revox.voices.preview(provider: :cartesia, voice_id: "voiceId")

puts(result)

Returns Examples