API Reference

Voices

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get voices

voices.list() -> VoiceListResponse

GET/voices

Retrieve all voices available for AI calls, including preset voices from Cartesia/ElevenLabs and your organization's cloned voices.

ReturnsExpand Collapse

class VoiceListResponse: …

voices: List[Voice]

id: str

The ID of the voice.

minLength1

description: str

The description of the voice.

language: Literal["en", "fr", "es", 5 more]

The language of the voice.

One of the following:

"en"

"fr"

"es"

"de"

"it"

"pt"

"ru"

"zh"

name: str

The name of the voice.

provider: Literal["cartesia", "elevenlabs"]

The provider of the voice.

One of the following:

"cartesia"

"elevenlabs"

accent: Optional[str]

The accent/dialect of the voice (e.g. 'american', 'british', 'australian', 'quebec').

gender: Optional[str]

The gender of the voice (e.g. 'male', 'female', 'neutral').

is_cloned: Optional[bool]

Whether this is a cloned voice.

Get voices

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
)
voices = client.voices.list()
print(voices.voices)

200 example

{
  "voices": [
    {
      "id": "x",
      "description": "description",
      "language": "en",
      "name": "name",
      "provider": "cartesia",
      "accent": "accent",
      "gender": "gender",
      "isCloned": true
    }
  ]
}

Returns Examples

200 example

{
  "voices": [
    {
      "id": "x",
      "description": "description",
      "language": "en",
      "name": "name",
      "provider": "cartesia",
      "accent": "accent",
      "gender": "gender",
      "isCloned": true
    }
  ]
}