Skip to main content

What Is a Voice Profile?

A Voice Profile bundles three things into a single reusable configuration:
  • Speech-to-Text (STT) - transcribes the caller’s audio into text
  • Text-to-Speech (TTS) - converts agent text into natural-sounding audio
  • Voice - the specific voice identity (gender, accent, character) used for TTS output
When you attach a voice profile to an agent, every call that voice handles uses that configuration automatically - including failover if a provider goes down. Voice profiles are managed by Unpod. You browse and select from the available list - you do not configure STT/TTS providers directly.

Listing Voice Profiles via SDK

VoiceProfile fields


Getting a Single Profile


Choosing the Right Profile

By use case

By latency

Total call latency has three components: STT transcription + LLM thinking + TTS synthesis.
  • Choose quality == "high" when voice naturalness matters more than speed
  • Choose quality == "standard" for latency-sensitive or high-volume deployments
  • Check latency_ms on the profile object for the estimated end-to-end figure

Using a Profile When Creating an Agent

Pass profile_id as voice_profile when you create the agent:

Giving an Agent a Second Voice

One agent, one brain, many voices - a second language is a second voice, not a second agent. The new voice inherits the brain unchanged.

Next Steps

Agents

Attach a voice profile when creating an agent, and add more voices later.

AgentRunner & Sessions

Install the SDK and configure your runner process.