MiniMax

Overview

MiniMaxTTSService 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 with emotional voice settings

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:"Calm_Woman"

deprecated

Voice identifier for synthesis.Deprecated in v0.0.105. Use settings=MiniMaxHttpTTSService.Settings(...) instead.

str

default:"speech-02-turbo"

deprecated

TTS model name. Options include speech-2.6-hd, speech-2.6-turbo, speech-02-hd, speech-02-turbo, speech-01-hd, speech-01-turbo.Deprecated in v0.0.105. 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.

InputParams

default:"None"

deprecated

Runtime-configurable voice and generation settings. See Settings below.Deprecated in v0.0.105. 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`	`None`	Model identifier. (Inherited.)
`voice`	`str`	`None`	Voice identifier. (Inherited.)
`language`	`Language \| str`	`None`	Language for synthesis. (Inherited.)
`speed`	`float`	`NOT_GIVEN`	Speech speed.
`volume`	`float`	`NOT_GIVEN`	Volume level.
`pitch`	`int`	`NOT_GIVEN`	Pitch adjustment.
`emotion`	`str`	`NOT_GIVEN`	Emotion for synthesis.
`text_normalization`	`bool`	`NOT_GIVEN`	Whether to apply text normalization.
`latex_read`	`bool`	`NOT_GIVEN`	Whether to read LaTeX formulas.
`language_boost`	`str`	`NOT_GIVEN`	Language boost setting.

Usage

Basic Setup

import aiohttp
from pipecat.services.minimax 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 import MiniMaxHttpTTSService
from pipecat.transcriptions.language import Language

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=Language.ZH,
            speed=1.2,
            emotion="happy",
        ),
    )

The InputParams / params= pattern is deprecated as of v0.0.105. Use Settings / settings= instead. See the Service Settings guide for migration details.

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 are the latest and 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.

Pipecat Server

Client SDKs

Pipecat Flows

Pipecat Cloud

CLI

Pipecat Context Hub

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