Fish Audio TTS

Overview

Fish Audio text-to-speech is available in LiveKit Agents through LiveKit Inference and the Fish Audio plugin. With LiveKit Inference, your agent runs on LiveKit's infrastructure to minimize latency. No separate provider API key is required, and usage and rate limits are managed through LiveKit Cloud. Use the plugin instead if you want to manage your own billing and rate limits. Pricing for LiveKit Inference is available on the pricing page .

This plugin allows you to use Fish Audio  as a TTS provider for your voice agents.

LiveKit Inference

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

Usage

To use Fish Audio, use the TTS class from the inference module:

from livekit.agents import AgentSession, inference

session = AgentSession(
    tts=inference.TTS(
        model="fishaudio/s2.1-pro",
        voice="b347db033a6549378b48d00acb0d06cd",
        language="en",
        extra_kwargs={
            "speed": 1.5,
            "volume": 1.2,
        }
    ),
    # ... tts, stt, vad, turn_handling, etc.
)

import { AgentSession, inference } from '@livekit/agents';

session = new AgentSession({
    tts: new inference.TTS({
        model: "fishaudio/s2.1-pro",
        voice: "b347db033a6549378b48d00acb0d06cd",
        language: "en",
        modelOptions: {
            speed: 1.5,
            volume: 1.2,
        }
    }),
    // ... tts, stt, vad, turnHandling, etc.
});

Parameters

Model parameters

Pass the following parameters inside extra_kwargs (Python) or modelOptions (Node.js):

Voices

LiveKit Inference supports all of the default "Fish Audio Voices" available in the Fish Audio API. You can explore the available voices in the Fish Audio voice library  (free account required), and use the voice by copying its ID into your LiveKit agent session.

The following is a small sample of the Fish Audio voices available in LiveKit Inference.

String descriptors

As a shortcut, you can also pass a descriptor with the model ID and voice directly to the tts argument in your AgentSession:

from livekit.agents import AgentSession

session = AgentSession(
    tts="fishaudio/s2.1-pro:b347db033a6549378b48d00acb0d06cd",
    # ... llm, stt, vad, turn_handling, etc.
)

import { AgentSession } from '@livekit/agents';

session = new AgentSession({
    tts: "fishaudio/s2.1-pro:b347db033a6549378b48d00acb0d06cd",
    // ... llm, stt, vad, turnHandling, etc.
});

Plugin

LiveKit's plugin support for Fish Audio lets you connect directly to Fish Audio's TTS API with your own API key.

Installation

Install the plugin from PyPI:

uv add "livekit-agents[fishaudio]~=1.6"

Authentication

The Fish Audio plugin requires an API key from Fish Audio .

Set FISH_API_KEY in your .env.local file.

Usage

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

from livekit.plugins import fishaudio

session = AgentSession(
    tts=fishaudio.TTS(
        model="s2.1-pro",
        voice_id="933563129e564b19a115bedd57b7406a",
    ),
    # ... llm, stt, etc.
)

Voices

Fish Audio identifies each voice by a reference ID. Browse the Fish Audio playground  to find a voice, or create your own custom voice model, then copy its ID into the voice_id parameter.

Parameters

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

Additional resources

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

Python package

The livekit-plugins-fishaudio package on PyPI.

Plugin reference

Reference for the Fish Audio TTS plugin.

GitHub repo

View the source or contribute to the LiveKit Fish Audio TTS plugin.

Fish Audio docs

Fish Audio's full docs site.