API Reference

Voices

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get voice by ID

voices.retrieve(strid, VoiceRetrieveParams**kwargs) -> VoiceRetrieveResponse

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: str

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

One of the following:

"cartesia"

"elevenlabs"

ReturnsExpand Collapse

class VoiceRetrieveResponse: …

voice: Voice

id: str

name: str

description: Optional[str]

Get voice by ID

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
)
voice = client.voices.retrieve(
    id="id",
    provider="cartesia",
)
print(voice.voice)

200 example

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

Returns Examples

200 example

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