Skip to main content
Fonoster calls speech and language vendors for you. Every provider, model and voice has a catalog ID of the form <provider>/<name>, and your applications and agents name them by that ID. This page lists the default catalog and explains how a deprecation shows up. The catalog your workspace sees can differ: it lists only providers the platform or your workspace has a key for, and the operator of a self-hosted install can add or remove entries. To see yours, run:

​
Where catalog IDs go

When you save an application, Fonoster checks its voice and speech models against the catalog. An ID that isn’t in the catalog is refused, and so is a retired one, with its replacement in the message. See Autopilot configuration for every field.

​
Providers

​
Speech-to-text models

multi means the model hears more than one language in the same call.

​
Text-to-speech models

​
Voices

Pick a voice that speaks the application’s speech.language.

​
Deepgram Aura-2

These voices run on deepgram/aura-2. deepgram/aura-2-thalia-en is the default voice of a new application.

​
ElevenLabs

These voices run on elevenlabs/eleven_flash_v2_5 and speak several languages (multi). The catalog ID uses ElevenLabs’ voice ID.

​
Language models

Autopilot agents run language models with an OpenAI-compatible API. An agent with tools needs a model with tool calling; every model below has it. Groq models use Groq’s own model name after groq/. On a self-hosted install, the operator can also add models served by Ollama.

​
Deprecation and retirement

Each catalog entry is in one of three states:

​
When an entry is deprecated

Nothing changes for your calls until the retirement date. You find out in these places:
  • Webhook: a provider.deprecated event, sent once to each workspace whose saved applications or agents name the entry. It carries id, replacement and retireOn.
  • CLI: fonoster providers:catalog shows the state as deprecated → <replacement>.
  • Dashboard: a warning for each deprecated entry your applications name or used lately, with the retirement date, the replacement and the applications that use it.
  • Call record: a call that used the entry notes provider.deprecated_used.
To move, change the ID in each application and agent that names it, then make a test call. A replacement can sound or behave a little differently. See Use your own vendor keys.

​
When an entry is retired

On the retirement date, Fonoster moves saved applications and agents to the replacement. Settings the replacement doesn’t accept are dropped. A setting that can’t move, such as a voice that exists only on the old model, keeps the old ID, and calls use the replacement for it. After that:
  • The entry no longer appears in the catalog.
  • Saving an application with the retired ID is refused, with the replacement in the message.
  • A call that still names it runs on the replacement, and its call record notes provider.retired_used.
If a vendor is down, Fonoster doesn’t switch your calls to another vendor on its own. A stream gets a provider_unavailable error and decides what to do.

​
Bring your own keys

By default, calls use the platform’s account with each vendor. Set your own key for a provider, and your workspace’s calls use your account instead. A provider the platform has no key for appears in your catalog once you set one. See Use your own vendor keys.