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

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