API Overview

​

Get API Key

• Coding Plan：Visit API Keys > Create Coding Plan Key to get your API Key
  Coding Plan only supports MiniMax text models. See Coding Plan Overview for details.
• Pay-as-you-go：Visit API Keys > Create new secret key to get your API Key
  Pay-as-you-go supports all modality models, including Text, Video, Speech, and Image.

---

​

Text Generation

The text generation API uses MiniMax M2.1, MiniMax M2.1 lightning, MiniMax M2 to generate conversational content and trigger tool calls based on the provided context. It can be accessed via HTTP requests, the Anthropic SDK (Recommended), or the OpenAI SDK.

​

Supported Models

Please note: The maximum token count refers to the total number of input and output tokens.

---

​

Text to Speech (T2A)

This API provides synchronous text-to-speech (T2A) generation, supporting up to 10,000 characters per request. The interface is stateless: each call only processes the provided input without involving business logic, and the model does not store any user data. Key Features

1. Access to 300+ system voices and custom cloned voices.
2. Adjustable volume, pitch, speed, and output formats.
3. Support for proportional audio mixing.
4. Configurable fixed time intervals.
5. Multiple audio formats and specifications supported: mp3, pcm, flac, wav (wav is supported only in non-streaming mode).
6. Support for streaming output.

Typical Use Cases: short text generation, voice chat, online social interactions.

​

Supported Models

​

Available Interfaces

Synchronous speech synthesis provides two interfaces. Choose based on your needs:

• HTTP T2A API
• WebSocket T2A API

​

Supported Languages

MiniMax speech synthesis models offer robust multilingual capability, supporting 40 widely used languages worldwide.

---

​

Asynchronous Long-Text Speech Generation (T2A Async)

This API supports asynchronous text-to-speech generation. Each request can handle up to 1 million characters, and the resulting audio can be retrieved asynchronously. Features supported:

1. Choose from 100+ system voices and cloned voices.
2. Customize pitch, speed, volume, bitrate, sample rate, and output format.
3. Retrieve audio metadata, such as duration and file size.
4. Retrieve precise sentence-level timestamps (subtitles).
5. Input text directly as a string or via file_id after uploading a text file.
6. Detect illegal characters:
   • If illegal characters are ≤10%, audio is generated normally, with the ratio returned.
   • If illegal characters are >10%, no audio will be generated (an error code will be returned).

Note: The returned audio URL is valid for 9 hours (32,400 seconds) from the time it is issued. After expiration, the URL becomes invalid and the generated data will be lost. Use Case: Converting entire books or other long texts into audio.

​

Supported Models

​

API Overview

This feature includes two APIs:

1. Create a speech generation task (returns task_id).
2. Query the speech generation task status using task_id.
3. If the task succeeds, use the returned file_id with the File API to view and download the result.

---

​

Voice Cloning

This API supports cloning voices from user-uploaded audio files along with optional sample audio to enhance cloning quality. Use cases: fast replication of a target timbre (IP voice recreation, voice cloning) where you need to quickly clone a specific voice. The API supports cloning from mono or stereo audio and can rapidly reproduce speech that matches the timbre of a provided reference file.

​

Supported Models

​

Notes

• Using this API to clone a voice does not immediately incur a cloning fee. The fee is charged the first time you synthesize speech with the cloned voice in a T2A synthesis API.
• Voices produced via this rapid cloning API are temporary. To keep a cloned voice permanently, call any T2A speech synthesis API with that voice within 168 hours (7 days).

---

​

Voice Design

This API supports generating personalized custom voices based on user-provided voice description prompts. The generated voices (voice_id) can then be used in the T2A API and the T2A Async API for speech generation.

​

Supported Models

It is recommended to use speech-02-hd for the best results.

​

Notes

• Using this API to generate a voice does not immediately incur a fee. The generation fee will be charged upon the first use of the generated voice in speech synthesis.
• Voices generated through this API are temporary. If you wish to keep a voice permanently, you must use it in any speech synthesis API within 168 hours (7 days).

Voice Design API

Generate personalized voices from descriptions

View Docs

---

​

Video Generation

This API supports generating videos based on user-provided text, images (including first frame, last frame, or reference images).

​

Supported Models

​

API Usage Guide

Video generation is asynchronous and consists of three APIs: Create Video Generation Task, Query Video Generation Task Status, and File Management. Steps are as follows:

1. Use the Create Video Generation Task API to start a task. On success, it will return a task_id.
2. Use the Query Video Generation Task Status API with the task_id to check progress. When the status is success, a file ID (file_id) will be returned.
3. Use the Download the Video File API with the file_id to view and download the generated video.

---

​

Video Generation Agent

This API supports video generation tasks based on user-selected video agent templates and inputs.

​

Overview

The Video Agent API works asynchronously and includes two endpoints: Create Video Agent Task and Query Video Agent Task Status. Usage steps:

1. Use the Create Video Agent Task API to create a task and obtain a task_id.
2. Use the Query Video Agent Task Status API with the task_id to check the task status. Once the status is Success, you can retrieve the corresponding file download URL.

​

Template List

For details and examples, refer to the Video Agent Template List.

---

​

Image Generation

This API supports images generations from text or references, allowing custom aspect ratios and resolutions for diverse needs.

​

API Description

You can generate images by creating an image generation task using text prompts and/or reference images.

​

Model List

---

​

Music Generation

This API generates a vocal song based on a music description (prompt) and lyrics.

​

Models

Music Generation API

Generate music from description and lyrics

View Docs

---

​

File Management

This API is for file management and is used with other MiniMax APIs.

​

API Description

This API includes 5 endpoints: Upload, List, Retrieve, Retrieve Content, Delete.

​

Supported File Formats

​

Capacity and Limits

---

​

Official MCP

MiniMax provides official Model Context Protocol (MCP) server implementations:

• Python version
• JavaScript version

Both support speech synthesis, voice cloning, video generation, and music generation. For details, refer to the MiniMax MCP User Guide.