Browse available voices and set an agent’s voice for AI-powered phone calls.
Voice Catalog
Every Anima agent speaks with a single, high-quality voice. The catalog is multilingual — voices span English, Spanish, French, German, Italian, Japanese, and Dutch, each with its own accent and tone. Use the voice catalog to browse the available voices, then set one on your agent — it is used for all of that agent’s calls.
List voices
from anima import Animaanima = Anima(api_key="ak_...")voices = anima.voices.list()for voice in voices["voices"]: print(f"{voice.id}: {voice.name} ({voice.gender}, {voice.accent})")
import { Anima } from "@anima-labs/sdk";const anima = new Anima({ apiKey: "ak_..." });const voices = await anima.voices.list();for (const voice of voices.voices) { console.log(`${voice.id}: ${voice.name} (${voice.gender}, ${voice.accent})`);}
Each voice has an id (e.g. thalia), a display name, a gender, an accent, an optional age, a set of descriptors (tone words such as “warm” or “smooth”), suggested useCases, a language, and a sampleUrl — a short audio preview you can play to hear the voice.
Each voice carries a sampleUrl — a short audio clip you can play to hear how it sounds before assigning it. The preview is served from the Anima API, so you can embed or fetch it directly.
voices = anima.voices.list(language="es")for voice in voices["voices"]: if voice.sample_url: print(f"{voice.name}: {voice.sample_url}")
const { voices } = await anima.voices.list({ language: "es" });for (const voice of voices) { if (voice.sampleUrl) console.log(`${voice.name}: ${voice.sampleUrl}`);}
sampleUrl appears once a preview clip has been generated for a voice; a voice without a generated clip omits the field.
Set an agent’s voice
A voice is a property of the agent, not the call. Set voiceId when you create or update an agent, and every call that agent places or receives uses it. Omit it to use the system default voice.
Call creation takes to, an optional agentId, an optional greeting, and an optional fromNumber — the voice comes from the agent.
call = anima.calls.create( agent_id="AGENT_ID", to="+15551234567", greeting="Hi, this is my Anima agent calling from its own number.",)print(call.call_id, call.state)
const call = await anima.calls.create({ agentId: "AGENT_ID", to: "+15551234567", greeting: "Hi, this is my Anima agent calling from its own number.",});console.log(call.callId, call.state);