List Voices

Get all available text-to-speech voices

The voices endpoint returns a list of all available voices for speech generation.

Endpoint

GET /v1/talk/voices

Authentication

Requires a do_live_* API key with the talk:voices scope.

Request Example

curl -H "Authorization: Bearer do_live_your_key_here" \
  "https://api.do.dev/v1/talk/voices"

Response

Success (200 OK)

{
  "voices": [
    {
      "id": "thalia",
      "name": "Zara",
      "gender": "female",
      "accent": "american",
      "description": "Clear, Confident, Energetic"
    },
    {
      "id": "helena",
      "name": "Grace",
      "gender": "female",
      "accent": "american",
      "description": "Caring, Natural, Friendly"
    },
    {
      "id": "apollo",
      "name": "Max",
      "gender": "male",
      "accent": "american",
      "description": "Confident, Casual, Comfortable"
    }
  ]
}

Voice Reference

Female Voices

ID	Name	Accent	Model	Description	Best For
`thalia`	Zara	American	Aura-2	Clear, Confident, Energetic	Customer service, announcements
`helena`	Grace	American	Aura-2	Caring, Natural, Friendly	IVR systems, support
`aria`	Claire	American	Aura-2	Warm, Professional, Expressive	Business, presentations
`cora`	Sage	American	Aura-2	Smooth, Calm, Soothing	Meditation, relaxation
`emma`	Victoria	British	Aura-2	Elegant, Refined, Clear	Formal content, luxury brands
`evelyn`	Maya	American	Aura-2	Warm, Empathetic, Approachable	Healthcare, education
`asteria`	Echo	American	Aura	Classic, Clear	General purpose
`luna`	Serena	American	Aura	Soft, Gentle	Audiobooks, storytelling
`stella`	Nova	American	Aura	Bright, Energetic	Marketing, ads
`athena`	Iris	British	Aura	Sophisticated, Wise	Documentation, tutorials

Male Voices

ID	Name	Accent	Model	Description	Best For
`apollo`	Max	American	Aura-2	Confident, Casual, Comfortable	Podcasts, casual content
`orion`	Drake	American	Aura-2	Deep, Authoritative, Clear	News, announcements
`theo`	Finn	American	Aura-2	Friendly, Natural, Warm	Customer support, tutorials
`marcus`	Blake	American	Aura-2	Professional, Confident, Clear	Business, corporate
`james`	Oliver	British	Aura-2	Refined, Articulate, Warm	Documentaries, formal content
`zeus`	Atlas	American	Aura	Commanding, Strong	Action, gaming
`orpheus`	Phoenix	American	Aura	Smooth, Melodic	Music, entertainment

Aura-2 vs Legacy Aura

Aura-2 voices are newer and more natural-sounding. We recommend using Aura-2 voices for new projects. Legacy Aura voices are maintained for backward compatibility.

You can use custom/cloned voices from ElevenLabs by passing the voice ID via the customVoiceId parameter in the speech endpoint. Custom voices are detected automatically if the voice string matches:

Starts with custom_ prefix
Is a 20+ character alphanumeric string (ElevenLabs voice ID format)

Code Examples

JavaScript

async function listVoices() {
  const response = await fetch("https://api.do.dev/v1/talk/voices", {
    headers: {
      "Authorization": `Bearer ${process.env.DO_API_KEY}`
    }
  });

  const data = await response.json();
  return data.voices;
}

// Get all female voices
const voices = await listVoices();
const femaleVoices = voices.filter(v => v.gender === "female");
console.log(femaleVoices);

Python

import requests
import os

def list_voices():
    response = requests.get(
        "https://api.do.dev/v1/talk/voices",
        headers={"Authorization": f"Bearer {os.environ['DO_API_KEY']}"}
    )
    return response.json()["voices"]

# Get all British voices
voices = list_voices()
british_voices = [v for v in voices if v["accent"] == "british"]
print(british_voices)

Choosing the Right Voice

Consider these factors when selecting a voice:

Content Type — Formal content suits professional voices (marcus, emma), casual content suits friendly voices (apollo, theo)
Target Audience — Match accent to audience preferences
Brand Personality — Choose voices that align with your brand tone
Use Case — IVR systems benefit from clear voices (thalia, helena), meditation apps need calm voices (cora)