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 a Speech Pipe, every call that Speech Pipe handles uses that configuration automatically — including failover if a provider goes down.
Voice profile pipeline diagram showing caller speech passing through STT, dialog machine text handling, TTS plus voice, and caller playback.
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

import asyncio
from unpod import AsyncClient

async def main():
    async with AsyncClient(api_key="sk-...") as client:
        # All profiles
        profiles = await client.voice_profiles.list()

        # Filter by language
        en_profiles = await client.voice_profiles.list(language="en")
        es_profiles = await client.voice_profiles.list(language="es")

        for p in profiles:
            print(
                p.profile_id,
                p.name,
                f"gender={p.gender}",
                f"quality={p.quality}",
            )

asyncio.run(main())

​
VoiceProfile fields

FieldTypeDescription
profile_idstrProfile ID to pass when creating a Speech Pipe
namestrHuman-readable name, e.g. "Emma (HD)"
genderstrmale, female, or neutral
qualitystrstandard or high
languageslist[str]Supported language codes, e.g. ["en", "hi"]
descriptionstr | NoneShort description of the voice character
latency_msint | NoneExpected end-to-end latency in milliseconds
greeting_messagestr | NoneDefault greeting for this profile

​
Getting a Single Profile

import asyncio
from unpod import AsyncClient

async def main():
    async with AsyncClient(api_key="sk-...") as client:
        profile = await client.voice_profiles.get("vp_en_female_hd")
        print(profile.name, profile.quality, profile.languages)

asyncio.run(main())

​
Choosing the Right Profile

​
By use case

Use caseRecommended qualities
Customer supportHigh quality, natural voice, low latency
Sales outreachExpressive, high quality, brand-matched
Appointment bookingStandard quality — lower latency
MultilingualMatch language codes to caller’s region

​
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 a Speech Pipe

Pass profile_id directly when creating or updating a Speech Pipe: 
import asyncio
from unpod import AsyncClient

async def main():
    async with AsyncClient(api_key="sk-...") as client:
        # List to find the right profile
        profiles = await client.voice_profiles.list(language="en")
        hd_female = next(
            p for p in profiles if p.quality == "high" and p.gender == "female"
        )

        # Create Speech Pipe with that profile
        pipe = await client.pipes.create(
            name="Support Bot",
            voice_profile=hd_female.profile_id,
        )
        print("Created Speech Pipe with profile:", hd_female.name)

asyncio.run(main())

​
Switching a Profile on an Existing Speech Pipe

import asyncio
from unpod import AsyncClient

async def main():
    async with AsyncClient(api_key="sk-...") as client:
        pipe = await client.pipes.update(
            "pipe_...",
            voice_profile="vp_es_male_std",   # switch to Spanish male
        )
        print("Updated voice profile:", pipe.voice_profile_id)

asyncio.run(main())

​
Next Steps

Speech Pipe

Attach a voice profile when creating or updating a Speech Pipe.

SDK Setup

Install the SDK and configure your runner process.