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

The provider to use for the preview.

One of the following:

:cartesia

:elevenlabs

:gradium

voice_id: String

The voice ID to generate a preview for.

model: :"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: 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