> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useanima.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice Catalog

> 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

```python theme={null}
from anima import Anima

anima = Anima(api_key="ak_...")

voices = anima.voices.list()

for voice in voices["voices"]:
    print(f"{voice.id}: {voice.name} ({voice.gender}, {voice.accent})")
```

```ts theme={null}
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.

## Filters

The catalog supports these optional filters:

| Filter | Values |
| - | - |
| `gender` | `male`, `female`, `neutral` |
| `language` | language code — one of `en`, `es`, `fr`, `de`, `it`, `ja`, `nl` |

```python theme={null}
female_voices = anima.voices.list(gender="female")
english_voices = anima.voices.list(language="en")
```

```ts theme={null}
const femaleVoices = await anima.voices.list({ gender: "female" });
const englishVoices = await anima.voices.list({ language: "en" });
```

## Preview a 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.

```python theme={null}
voices = anima.voices.list(language="es")
for voice in voices["voices"]:
    if voice.sample_url:
        print(f"{voice.name}: {voice.sample_url}")
```

```ts theme={null}
const { voices } = await anima.voices.list({ language: "es" });
for (const voice of voices) {
  if (voice.sampleUrl) console.log(`${voice.name}: ${voice.sampleUrl}`);
}
```

<Note>
  `sampleUrl` appears once a preview clip has been generated for a voice; a voice without a generated clip omits the field.
</Note>

## 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.

```python theme={null}
agent = anima.agents.update(id="AGENT_ID", voice_id="thalia")
```

```ts theme={null}
const agent = await anima.agents.update({ id: "AGENT_ID", voiceId: "thalia" });
```

## Place a call

Call creation takes `to`, an optional `agentId`, an optional `greeting`, and an optional `fromNumber` — the voice comes from the agent.

```python theme={null}
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)
```

```ts theme={null}
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);
```

## REST endpoint

```bash theme={null}
curl "https://api.useanima.sh/v1/voice/catalog" \
  -H "Authorization: Bearer ak_..."
```

## Next steps

* [Quickstart: Voice Calls](/quickstart-voice) - Text yourself, then place the first call
* [Call Intelligence](/call-intelligence) - Transcripts, summaries, scores, and recordings
* [Voice WebSocket Protocol](/protocols/voice-websocket) - Real-time call event streaming


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.