API Reference

Voices

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get voices

client.voices.list(RequestOptionsoptions?): VoiceListResponse { voices }

GET/voices

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

ReturnsExpand Collapse

VoiceListResponse { voices }

voices: Array<Voice>

id: string

The ID of the voice.

minLength1

description: string

The description of the voice.

language: "en" | "fr" | "es" | 5 more

The language of the voice.

One of the following:

"en"

"fr"

"es"

"de"

"it"

"pt"

"ru"

"zh"

name: string

The name of the voice.

provider: "cartesia" | "elevenlabs"

The provider of the voice.

One of the following:

"cartesia"

"elevenlabs"

accent?: string

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

gender?: string

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

isCloned?: boolean

Whether this is a cloned voice.

Get voices

TypeScript

HTTP

TypeScript

Python

Ruby

import Revox from '@revoxai/sdk';

const client = new Revox({
  apiKey: process.env['REVOX_API_KEY'], // This is the default and can be omitted
});

const voices = await client.voices.list();

console.log(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
    }
  ]
}