Voices

Every agent speaks in one voice, set by voice.voice_id.

Finding a voice_id

There is no GET /v2/voices yet. The live catalogue is the voice picker in the console — open Agent Studio and you can hear each voice before you commit to one. The name in the picker is the voice_id. ashu and siya are the Hindi/Hinglish voices on t1 today. The catalogue grows monthly; treat the picker, not this page, as the source of truth. An unknown voice_id is rejected at agent-create time with 400 invalid_request.

Listen before you pick. Voice choice moves answer-through rates more than prompt wording does.

Setting a voice on an agent

{
  "name": "Order confirmations",
  "system_prompt": "…",
  "voice": { "voice_id": "ashu", "language": "hi-IN" },
  "language": "hi-IN"
}

Field	Type	Description
`voice_id`	string	A voice from the picker, e.g. `ashu`. Required. Unknown ⇒ `400`.
`language`	string	Rendering language. Omit to inherit the agent’s top-level `language`. Accepted and stored, not yet honoured — see below.

Change it later with PATCH /v2/agents/{id}:

curl -X PATCH https://api.voice.miraiminds.co/v2/agents/agt_… \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "voice": { "voice_id": "siya", "language": "hi-IN" } }'

See the Agents reference for the full agent shape.

The language caveat

voice.language is recorded, not yet appliedIt is validated, stored, echoed back and carried with the call payload — but the voice renders in the agent’s top-level language. Set both to the same value and you get what you expect; set them differently and the top-level one wins.

Keep voice.language and the agent’s language identical.

Premium voices

A wider set, with automatic fallback, is a t3 feature. See Billing & tiers.

Start here

Build

Money

Reference

Finding a voice_id

Setting a voice on an agent

The language caveat

Premium voices

​Finding a voice_id

​Setting a voice on an agent

​The language caveat

​Premium voices

Finding a voice_id

Setting a voice on an agent

The language caveat

Premium voices