API Reference

Voices

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get voice by ID

client.voices.retrieve(stringid, VoiceRetrieveParams { provider } query, RequestOptionsoptions?): VoiceRetrieveResponse { voice }

GET/voices/{id}

Retrieve details for a single voice by its unique ID and provider. Returns the voice name, description, and provider metadata.

ParametersExpand Collapse

id: string

query: VoiceRetrieveParams { provider }

provider: "cartesia" | "elevenlabs"

One of the following:

"cartesia"

"elevenlabs"

ReturnsExpand Collapse

VoiceRetrieveResponse { voice }

voice: Voice { id, name, description }

id: string

name: string

description?: string

Get voice by ID

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 voice = await client.voices.retrieve('id', { provider: 'cartesia' });

console.log(voice.voice);

200 example

{
  "voice": {
    "id": "id",
    "name": "name",
    "description": "description"
  }
}

Returns Examples

200 example

{
  "voice": {
    "id": "id",
    "name": "name",
    "description": "description"
  }
}