Voices

Choose the voice and language your calls speak from the 22 Dairo Live voices.

Every call speaks with one of 22 Dairo Live voices. Leave voice unset and calls use marin, a warm, clear voice; set language to hold the call in another language, or pick a different voice from the list below.

Set the language

Calls default to English. Set language to an ISO code and the agent both speaks and understands that language — with the default voice or any voice you choose:

{
  "to": "+13125550147",
  "from": "+13125550100",
  "instructions": "Erinnere Frau Weber daran, dass die Rechnung INV-2201 am Freitag fällig ist. Biete an, sie per E-Mail erneut zu senden.",
  "language": "de"
}

The agent phrases things itself. Give instructions a goal, a tone, and the facts it may share rather than lines to read verbatim — a brief produces a natural conversation, a script produces a recital.

Pick a voice

Pass the voice id as the call's voice (or as a number's inboundVoice for inbound calls). Any id outside this list is rejected with 400.

The first ten voices are multilingual — they speak whatever language you set:

Voice idGenderCharacter
marinfemaleWarm, natural and clear — the default voice.
cedarmaleCalm, grounded and friendly.
alloyneutralBalanced and neutral.
ashmaleDirect and confident.
balladmaleSoft and expressive.
coralfemaleBright and upbeat.
echomaleEven and measured.
sagefemaleGentle and thoughtful.
shimmerfemaleLight and energetic.
versemaleLively and animated.

The other twelve carry a regional accent:

Voice idGenderAccent
quartzfemaleAustralian English
ripplemaleAustralian English
vespermaleBritish English
willowfemaleIrish English
stonemaleIrish English
gleamfemaleNorth American English
meridianmaleNorth American English
bossafemaleBrazilian Portuguese
tempomaleBrazilian Portuguese
beaconmaleFilipino English
deltafemaleSouthern U.S. English
cindermaleSouthern U.S. English

Search the catalog

The same list is available as data. Fetch it with GET /v1/phone/voices, filtering by language, gender, or a free-text q, or ask for it with the search_voices tool on Dairo's MCP server:

curl "https://api.dairo.app/v1/phone/voices?q=british" \
  -H "Authorization: Bearer $DAIRO_API_KEY"

Each row carries the voice's voiceId, name, description, language (multilingual, en, or pt), gender, and accent:

{
  "object": "list",
  "kind": "phone",
  "count": 1,
  "data": [
    {
      "voiceId": "vesper",
      "name": "Vesper",
      "description": "English with a British influence.",
      "language": "en",
      "gender": "male",
      "accent": "British"
    }
  ]
}

A language filter keeps the voices that speak it — multilingual voices match every language. Pass the winning row's voiceId as the call's voice, together with language when the call isn't in English. Both fields are set per call on Making calls.

On this page