Text to Speech

VoiceRun supports a wide variety of voices across multiple TTS providers including OpenAI, Azure, Google, Cartesia, ElevenLabs, Fish Audio, Gradium, Inworld, MiniMax, Qwen3, xAI Grok, and more.

Explore Available Voices#

Browse and preview all available voices in the Voice Library.

Voice Usage#

To use a voice in your agent, specify the voice name in a TextToSpeechEvent:

yield TextToSpeechEvent(
    text="Hello, this is a sample message!",
    voice="nova"
)

Audio can be made uninterruptible by setting the interruptible flag to False:

yield TextToSpeechEvent(
    text="This message cannot be interrupted.",
    voice="nova",
    interruptible=False
)

Using TextToSpeechIdentifier#

If you need to use a specific voice directly from a provider, you can use TextToSpeechIdentifier instead of a voice name string. This gives you direct access to any voice from a supported provider.

yield TextToSpeechEvent(
    text="Hello from Azure!",
    voice={"provider": "azure", "identifier": "en-AU-WilliamNeural"}
)

Supported Providers#

Examples#

# Azure Neural Voice
yield TextToSpeechEvent(
    text="G'day mate!",
    voice={"provider": "azure", "identifier": "en-AU-WilliamNeural"}
)

# Cartesia Voice (using voice ID)
yield TextToSpeechEvent(
    text="Hello from Cartesia!",
    voice={"provider": "cartesia", "identifier": "6f84f4b8-58a2-430c-8c79-688dad597532"}
)

# Google Chirp Voice
yield TextToSpeechEvent(
    text="Hello from Google!",
    voice={"provider": "google_chirp", "identifier": "laomedeia"}
)

# OpenAI Voice
yield TextToSpeechEvent(
    text="Hello from OpenAI!",
    voice={"provider": "openai", "identifier": "nova"}
)

# Custom Voice
yield TextToSpeechEvent(
    text="Hello from my custom voice!",
    voice={"provider": "custom", "identifier": "my_voicerun_custom_voice"}
)

# Fish Audio Voice
yield TextToSpeechEvent(
    text="Hello from Fish Audio!",
    voice={"provider": "fish_audio", "identifier": "d13f84b987ad4f22b56d2b47f4eb838e"}
)

# Gradium Voice
yield TextToSpeechEvent(
    text="Hello from Gradium!",
    voice={"provider": "gradium", "identifier": "YTpq7expH9539ERJ"}
)

# Inworld Voice
yield TextToSpeechEvent(
    text="Hello from Inworld!",
    voice={"provider": "inworld", "identifier": "Alex"}
)

# ElevenLabs Voice
yield TextToSpeechEvent(
    text="Hello from ElevenLabs!",
    voice={"provider": "elevenlabs", "identifier": "21m00Tcm4TlvDq8ikWAM"}
)

# xAI Grok Voice
yield TextToSpeechEvent(
    text="Hello from xAI Grok!",
    voice={"provider": "xai", "identifier": "eve"}
)

Provider Features#