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 the full catalog of voices available for AI calls. The list includes voices from Cartesia and ElevenLabs, each with a name, language, accent, and provider-specific ID. Use this endpoint to browse voices before assigning one to an assistant or a call.

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"

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"
    }
  ]
}

Returns Examples

200 example

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