MiniMax Text-to-Speech

Overview

MiniMaxHttpTTSService provides high-quality text-to-speech synthesis using MiniMax’s T2A (Text-to-Audio) API with streaming capabilities, emotional voice control, and support for multiple languages. The service offers various models optimized for different use cases, from low-latency to high-definition audio quality.

MiniMax TTS API Reference

Pipecat’s API methods for MiniMax TTS integration

Example Implementation

Complete example using MiniMax TTS

MiniMax Documentation

Official MiniMax T2A API documentation

MiniMax Platform

Access voice models and API credentials

Installation

To use MiniMax services, no additional dependencies are required beyond the base installation:

uv add "pipecat-ai"

Prerequisites

MiniMax Account Setup

Before using MiniMax TTS services, you need:

MiniMax Account: Sign up at MiniMax Platform
API Credentials: Get your API key and Group ID from the platform
Voice Selection: Choose from available voice models and emotional settings

Required Environment Variables

MINIMAX_API_KEY: Your MiniMax API key for authentication
MINIMAX_GROUP_ID: Your MiniMax group ID

Configuration

MiniMaxHttpTTSService

str

required

MiniMax API key for authentication.

str

required

MiniMax Group ID to identify project.

str

default:"None"

deprecated

Deprecated since 0.0.105, removed in 2.0.0. Use settings=MiniMaxHttpTTSService.Settings(...) instead.

str

default:"None"

deprecated

Deprecated since 0.0.105, removed in 2.0.0. Use settings=MiniMaxHttpTTSService.Settings(...) instead.

str

default:"https://api.minimax.io/v1/t2a_v2"

API base URL. Use https://api.minimaxi.chat/v1/t2a_v2 for mainland China or https://api-uw.minimax.io/v1/t2a_v2 for western United States.

aiohttp.ClientSession

required

An aiohttp session for HTTP requests.

int

default:"None"

Output audio sample rate in Hz. When None, uses the pipeline’s configured sample rate.

bool

default:"True"

Whether to request a streaming response from the MiniMax API.

InputParams

default:"None"

deprecated

Deprecated since 0.0.105, removed in 2.0.0. Use settings=MiniMaxHttpTTSService.Settings(...) instead.

MiniMaxHttpTTSService.Settings

default:"None"

Runtime-configurable settings. See Settings below.

Settings

Runtime-configurable settings passed via the settings constructor argument using MiniMaxHttpTTSService.Settings(...). These can be updated mid-conversation with TTSUpdateSettingsFrame. See Service Settings for details.

Parameter	Type	Default	Description
`model`	`str`	`"speech-2.8-turbo"`	Model identifier. (Inherited.)
`voice`	`str`	`"Calm_Woman"`	Voice identifier. (Inherited.)
`language`	`Language \| str`	`None`	Language used to split text into sentences; not sent to MiniMax. Use `language_boost` for synthesis. (Inherited.)
`speed`	`float`	`1.0`	Speech speed.
`volume`	`float`	`1.0`	Volume level.
`pitch`	`int`	`0`	Pitch adjustment.
`emotion`	`str`	`None`	Emotion for synthesis.
`text_normalization`	`bool`	`None`	Whether to apply text normalization.
`latex_read`	`bool`	`None`	Whether to read LaTeX formulas.
`language_boost`	`str`	`None`	MiniMax language name to boost, such as `"Chinese"`. `None` omits it.

Usage

Basic Setup

import os

import aiohttp
from pipecat.services.minimax.tts import MiniMaxHttpTTSService

async with aiohttp.ClientSession() as session:
    tts = MiniMaxHttpTTSService(
        api_key=os.getenv("MINIMAX_API_KEY"),
        group_id=os.getenv("MINIMAX_GROUP_ID"),
        aiohttp_session=session,
    )

With Voice Customization

import aiohttp
from pipecat.services.minimax.tts import MiniMaxHttpTTSService

async with aiohttp.ClientSession() as session:
    tts = MiniMaxHttpTTSService(
        api_key=os.getenv("MINIMAX_API_KEY"),
        group_id=os.getenv("MINIMAX_GROUP_ID"),
        aiohttp_session=session,
        settings=MiniMaxHttpTTSService.Settings(
            voice="Calm_Woman",
            model="speech-02-hd",
            language_boost="Chinese",
            speed=1.2,
            emotion="happy",
        ),
    )

Notes

HTTP-based streaming: MiniMax uses an HTTP streaming API, not WebSocket. Audio data is returned in hex-encoded PCM chunks.
Emotional voice control: The emotion parameter lets you adjust the emotional tone of the voice without changing the voice model itself.
Model selection: The speech-2.6-* models support additional languages (Filipino, Tamil, Persian). Use turbo variants for lower latency or hd variants for higher quality.
The Python class is named MiniMaxHttpTTSService, not MiniMaxTTSService.

Get Started

Pipecat Server

Client SDKs

Pipecat Flows

Pipecat Cloud

CLI

Pipecat Context Hub

MiniMax Text-to-Speech

Overview

MiniMax TTS API Reference

Example Implementation

MiniMax Documentation

MiniMax Platform

Installation

Prerequisites

MiniMax Account Setup

Required Environment Variables

Configuration

MiniMaxHttpTTSService

Settings

Usage

Basic Setup

With Voice Customization

Notes

​Overview

MiniMax TTS API Reference

Example Implementation

MiniMax Documentation

MiniMax Platform

​Installation

​Prerequisites

​MiniMax Account Setup

​Required Environment Variables

​Configuration

​MiniMaxHttpTTSService

​Settings

​Usage

​Basic Setup

​With Voice Customization

​Notes

Overview

Installation

Prerequisites

MiniMax Account Setup

Required Environment Variables

Configuration

MiniMaxHttpTTSService

Settings

Usage

Basic Setup

With Voice Customization

Notes