Skip to main content

​
Get API Key

  • 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 language, Video, Speech, and Image.
  • Token Plan：Visit Billing > Token Plan to view your Subscription Key
    The Subscription Key is used for Token Plan subscriptions and purchased Credits. It is separate from pay-as-you-go API Keys. See Token Plan Overview for details.

​
LLM

The LLM API uses MiniMax M3, MiniMax M2.7, MiniMax M2.7 highspeed, MiniMax M2.5, MiniMax M2.5 highspeed, MiniMax M2.1, MiniMax M2.1 highspeed, and 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.

Anthropic API Compatible (Recommended)

Use Anthropic SDK with MiniMax models

OpenAI API Compatible

Use OpenAI SDK with MiniMax models

​
MiniMax-H3 <NEW>

This API is powered by MiniMax-H3 and supports video generation from multimodal input (text, images, video, audio), covering text-to-video, image-to-video, first-and-last-frame, and reference-to-video scenarios. Supported Models API Usage Guide MiniMax-H3 tasks are asynchronous. There are three creation endpoints—Create Video Generation Task, Create H3-Context-IR Task, and Create Video Regeneration Task—and shared endpoints for querying, listing, and cancelling or deleting tasks. The workflow is as follows:
  1. Create a video generation task, create an H3-Context-IR task with the same multimodal input, or create a video regeneration task for a source video that meets the MiniMax-H3 768P output specifications. A regeneration request must contain exactly one source-video item with role=base_video. All three endpoints return a task_id on success.
  2. Use Query Task with the task_id to retrieve its status and result. When a video task succeeds, get its output URL from content.url; when an H3-Context-IR task succeeds, get the enhanced prompt from content.prompt. You can also use List Tasks and distinguish generation, h3_context_ir, and regeneration with task_type.
  3. Use Cancel or Delete Task to cancel a queued task or delete a succeeded or failed task record.

Create Video Generation Task

Create a video generation task from multimodal content input

Create H3-Context-IR Task

Deeply interpret multimodal video-generation context and produce a structured, enhanced prompt

Create Video Regeneration Task

Regenerate a video that meets the MiniMax-H3 768P output specifications as a 2K video

Query Task

Query task status by task_id and get the video download URL

List Tasks

List tasks from the last 7 days and filter by task type

Cancel or Delete Task

Cancel a queued task or delete a succeeded or failed task record

​
Text to Speech

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.
  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.

HTTP T2A API

Synchronous speech synthesis via HTTP

WebSocket T2A API

Streaming speech synthesis via WebSocket

​
Asynchronous Long-Text Speech Generation

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.

Create Async Task

Create a long-text speech generation task

Query Task Status

Query speech generation task status

​
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 cloning fee is charged the first time you synthesize speech with the cloned voice in a T2A synthesis API (the preview/audition within this API does not count).
  • 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) (the preview/audition within this API does not count). If the time limit is exceeded, the voice will be deleted.
  • This API is stateless: each call only processes the incoming data, does not store user-uploaded content, and involves no business-logic state.

Upload Clone Audio

Upload audio file to clone

Clone Voice

Execute voice cloning

​
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

​
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

Text to Image

Generate image from text description

Image to Image

Generate image from reference image

​
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

​
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 size limits are defined by the Upload File API documentation — see Upload File.

Upload File

Upload files to the platform

List Files

Get list of uploaded files

​
Official MCP

MiniMax provides official Model Context Protocol (MCP) server implementations: Both support speech synthesis, voice cloning, video generation, and music generation. For details, refer to the MiniMax MCP User Guide.