Skip to content
Get started

Get voices

client.voices.list(RequestOptionsoptions?): VoiceListResponse { voices }
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
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"

Get voices

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);
{
  "voices": [
    {
      "id": "x",
      "description": "description",
      "language": "en",
      "name": "name",
      "provider": "cartesia"
    }
  ]
}
Returns Examples
{
  "voices": [
    {
      "id": "x",
      "description": "description",
      "language": "en",
      "name": "name",
      "provider": "cartesia"
    }
  ]
}