Skip to main content

xAI TTS plugin guide

How to use the xAI TTS plugin for LiveKit Agents.

Use in Agent Builder

Create a new agent in your browser using this model

Overview

xAI text-to-speech is available in LiveKit Agents through LiveKit Inference and the xAI plugin. Pricing for LiveKit Inference is available on the pricing page.

Model IDLanguages
xai/tts-1
autoenar-EGar-SAar-AEbnzhfrdehiiditjakopt-BRpt-PTrues-MXes-EStrvi

LiveKit Inference

Use LiveKit Inference to access xAI TTS without a separate xAI API key.

Usage

To use xAI, pass a descriptor with the voice to the tts argument in your AgentSession:

from livekit.agents import AgentSession
session = AgentSession(
tts="xai/tts-1:ara",
# ... stt, llm, vad, turn_detection, etc.
)

Parameters

To customize additional parameters, use the TTS class from the inference module:

from livekit.agents import AgentSession, inference
session = AgentSession(
tts=inference.TTS(
model="xai/tts-1",
voice="ara",
language="en"
),
# ... stt, llm, vad, turn_detection, etc.
)
voicestringRequired

The voice ID used for speech generation.

languagestringOptional

Language code for the input text. If not set, the model default applies.

Plugin

Use the xAI plugin to connect directly to xAI's TTS API with your own API key.

Available in
Python

Installation

Install the plugin from PyPI:

uv add "livekit-agents[xai]~=1.4"

Authentication

The xAI plugin requires an xAI API key.

Set XAI_API_KEY in your .env file.

Usage

Use xAI TTS in an AgentSession or as a standalone speech generator. For example, you can use this TTS in the Voice AI quickstart.

from livekit.plugins import xai
session = AgentSession(
tts = xai.TTS(
voice="ara",
),
# ... llm, stt, etc.
)

Parameters

This section describes some of the available parameters. See the plugin reference links in the Additional resources section for a complete list of all available parameters.

voiceGrokVoices | stringOptionalDefault: ara

The voice ID used for speech generation.

Additional resources

The following resources provide more information about using xAI with LiveKit Agents.