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.

​
Large Language Model

The Large Language Model 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

​
Video Model

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

​
Speech Model

The speech models provide speech synthesis, voice cloning, and voice design, supporting 40 languages and 300+ system voices, with synchronous or asynchronous generation. All interfaces are stateless: each call only processes the provided input, does not store user data, and involves no business-logic state. Supported Models API Overview Four capabilities share the models above:
  1. Synchronous speech synthesis (T2A): real-time text-to-speech, up to 10,000 characters per request; 300+ system and cloned voices, adjustable volume / pitch / speed, proportional mixing, streaming output, and mp3 / pcm / flac / wav formats. Available over HTTP and WebSocket.
  2. Asynchronous long-text synthesis: up to 1 million characters per request, ideal for entire books; supports sentence-level timestamps (subtitles). Create a task to get a task_id, then use the returned file_id with the File API to download (the download URL is valid for 9 hours).
  3. Voice cloning: upload the audio to clone to get a file_id (optionally upload sample audio to improve quality), then call the cloning API to produce a custom voice_id. Individual or enterprise verification is required.
  4. Voice design: generate a personalized voice from a description prompt; the resulting voice_id can be used directly with the synthesis APIs above.
Voices produced by cloning and voice design are temporary: the fee is charged only on first use in speech synthesis (previews within those APIs do not count). If the voice is not used by any speech synthesis API within 168 hours (7 days), it is deleted.

HTTP T2A API

Synchronous speech synthesis via HTTP

WebSocket T2A API

Streaming speech synthesis via WebSocket

Create Async Task

Create a long-text speech generation task

Query Async Task Status

Query speech generation task status

Upload Clone Audio

Upload audio file to clone

Clone Voice

Execute voice cloning

Voice Design

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

Starting August 20, 2026, the paid APIs (Music Generation and Lyrics Generation) will no longer be available to new users; existing paying users can continue to use the current API services. The free music generation APIs (Music-3.0-free, Music-2.6-free, music-cover-free) will be discontinued.To experience or use music generation capabilities, please visit MiniMax Audio, or use the open-source MiniMax Music 3 model on Hugging Face.
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

​
Tools

Web Search web_search is a server-side web search tool hosted and executed by MiniMax. The model can retrieve up-to-date information while generating a response and answer based on the search results. It is available through both the Anthropic Messages API and the OpenAI Responses API. See Web Search for interface details and examples. 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.