Skip to main content

​
Voice Catalog

Use the voice catalog to inspect which voices are available for outbound phone calls. The current SDK exposes catalog listing and filtering; call creation uses the selected tier plus the agent’s configured voice pipeline.

​
List voices

from anima import Anima

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

voices = anima.voices.list(tier="basic")

for voice in voices["voices"]:
    print(f"{voice.id}: {voice.name} ({voice.provider}, {voice.language})")

import { Anima } from "@anima-labs/sdk";

const anima = new Anima({ apiKey: "ak_..." });

const voices = await anima.voices.list({ tier: "basic" });

for (const voice of voices.voices) {
  console.log(`${voice.id}: ${voice.name} (${voice.provider}, ${voice.language})`);
}

​
Filters

The catalog supports these optional filters:
FilterValues
tierbasic, premium
gendermale, female, neutral
languageBCP-47 language code, such as en-US
premium_voices = anima.voices.list(tier="premium")
female_voices = anima.voices.list(gender="female")
english_voices = anima.voices.list(language="en-US")

const premiumVoices = await anima.voices.list({ tier: "premium" });
const femaleVoices = await anima.voices.list({ gender: "female" });
const englishVoices = await anima.voices.list({ language: "en-US" });

​
Place a call

The public SDK call creation surface accepts to, optional agentId, tier, greeting, and optional fromNumber. 
call = anima.calls.create(
    agent_id="AGENT_ID",
    to="+15551234567",
    tier="basic",
    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",
  tier: "basic",
  greeting: "Hi, this is my Anima agent calling from its own number.",
});

console.log(call.callId, call.state);
Per-call voiceId, voiceSettings, and custom systemPrompt fields are not part of the current public SDK call input. Configure persistent agent behavior in the agent/voice pipeline, and use greeting for the opening line.

​
REST endpoint

curl "https://api.useanima.sh/v1/voice/catalog?tier=basic" \
  -H "Authorization: Bearer ak_..."

​
Next steps