Back to Ai

MiniMax

content/providers/03-community-providers/28-minimax.mdx

2.1.104.2 KB
Original Source

MiniMax Provider

vercel-minimax-ai-provider is a community provider that provides access to the latest MiniMax-M2 model from MiniMax.

API keys can be obtained from the MiniMax Platform.

Setup

The MiniMax provider is available via the vercel-minimax-ai-provider module. You can install it with:

<Tabs items={['pnpm', 'npm', 'yarn', 'bun']}> <Tab> <Snippet text="pnpm add vercel-minimax-ai-provider" dark /> </Tab> <Tab> <Snippet text="npm install vercel-minimax-ai-provider" dark /> </Tab> <Tab> <Snippet text="yarn add vercel-minimax-ai-provider" dark /> </Tab> <Tab> <Snippet text="bun add vercel-minimax-ai-provider" dark /> </Tab> </Tabs>

Provider Instance

The MiniMax provider supports two API compatibility modes:

Anthropic-Compatible API (Default)

You can import the default provider instance minimax from vercel-minimax-ai-provider:

ts
import { minimax } from 'vercel-minimax-ai-provider';

Or explicitly use the Anthropic-compatible instance:

ts
import { minimaxAnthropic } from 'vercel-minimax-ai-provider';

Or OpenAI-compatible API format:

ts
import { minimaxOpenAI } from 'vercel-minimax-ai-provider';

Custom Configuration

For custom configuration, you can use the createMinimax (Anthropic-compatible) or createMinimaxOpenAI (OpenAI-compatible) functions:

Anthropic-Compatible Configuration (Default)

ts
import { createMinimax } from 'vercel-minimax-ai-provider';

const minimax = createMinimax({
  apiKey: process.env.MINIMAX_API_KEY,
});

Configuration Options

You can use the following optional settings to customize the MiniMax provider instance:

  • baseURL string

    Use a different URL prefix for API calls.

    • Anthropic-compatible default: https://api.minimax.io/anthropic/v1
    • OpenAI-compatible default: https://api.minimax.io/v1
  • apiKey string

    API key that is being sent using the Authorization header. It defaults to the MINIMAX_API_KEY environment variable.

  • headers Record<string,string>

    Custom headers to include in the requests.

  • fetch (input: RequestInfo, init?: RequestInit) => Promise<Response>

    Custom fetch implementation.

API Compatibility

MiniMax provides two API formats. Both are included in this package.

The main difference is the API request/response format:

  • Anthropic format (default): Uses Anthropic Messages API format with anthropic-version header
  • OpenAI format: Uses standard OpenAI chat completion format

Both formats access the same MiniMax models with the same capabilities.

Model Capabilities

ModelText GenerationObject GenerationImage InputTool UsageTool Streaming
MiniMax-M2<Check size={18} /><Check size={18} /><Cross size={18} /><Check size={18} /><Check size={18} />
MiniMax-M2-Stable<Check size={18} /><Check size={18} /><Cross size={18} /><Check size={18} /><Check size={18} />
<Note> Please see the [MiniMax docs](https://platform.minimax.io/docs/api-reference/text-intro) for a full list of available models and their capabilities. The provider accepts any model ID as a string for forward compatibility. </Note>

Example Usage

Basic Text Generation

ts
import { minimax } from 'vercel-minimax-ai-provider';
import { generateText } from 'ai';

const result = await generateText({
  model: minimax('MiniMax-M2'),
  prompt: 'Explain quantum computing in simple terms.',
});

console.log(result.text);

Streaming

ts
import { minimax } from 'vercel-minimax-ai-provider';
import { streamText } from 'ai';

const result = streamText({
  model: minimax('MiniMax-M2'),
  prompt: 'Write a short story about a robot learning to paint.',
});

for await (const chunk of result.textStream) {
  console.log(chunk);
}