跳转到主要内容
为了满足开发者对 AI SDK 生态的使用需求，MiniMax 提供了官方社区 Provider。通过简单的配置，即可将 MiniMax 的能力接入到 AI SDK 生态中。

​
快速开始

​
1. 安装 AI SDK 和 MiniMax Provider

npm install ai vercel-minimax-ai-provider

​
2. 配置环境变量

export MINIMAX_API_KEY=${YOUR_API_KEY}

​
3. 调用 API

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

const { text, reasoning } = await generateText({
  model: minimax('MiniMax-M2.7'),
  system: 'You are a helpful assistant.',
  prompt: 'Hi, how are you?',
});

if (reasoning) {
  console.log(`Thinking:\n${reasoning}\n`);
}
console.log(`Text:\n${text}\n`);

​
4. 特别注意

在多轮 Function Call 对话中，必须将完整的模型返回（即 assistant 消息）添加到对话历史，以保持思维链的连续性：
  • 将完整的 result.response.messages 添加到消息历史（包含所有 assistant 和 tool 消息）

​
支持的模型

使用 AI SDK 时，支持 MiniMax-M2.7 MiniMax-M2.7-highspeed MiniMax-M2.5 MiniMax-M2.5-highspeed MiniMax-M2.1 MiniMax-M2.1-highspeed MiniMax-M2 模型：
模型名称上下文窗口模型介绍
MiniMax-M2.7204,800开启模型的自我迭代（输出速度约 60 TPS）
MiniMax-M2.7-highspeed204,800M2.7 极速版：效果不变，更快，更敏捷（输出速度约 100 TPS）
MiniMax-M2.5204,800顶尖性能与极致性价比，轻松驾驭复杂任务（输出速度约 60 TPS）
MiniMax-M2.5-highspeed204,800M2.5 极速版：效果不变，更快，更敏捷（输出速度约 100 TPS）
MiniMax-M2.1204,800强大多语言编程能力，全面升级编程体验（输出速度约 60 TPS）
MiniMax-M2.1-highspeed204,800M2.1 极速版：效果不变，更快，更敏捷（输出速度约 100 TPS）
MiniMax-M2204,800专为高效编码与 Agent 工作流而生
TPS（Tokens Per Second）的计算方式详见常见问题 > 接口相关。
AI SDK 兼容接口支持 MiniMax-M2.7 MiniMax-M2.7-highspeed MiniMax-M2.5 MiniMax-M2.5-highspeed MiniMax-M2.1 MiniMax-M2.1-highspeed MiniMax-M2 模型。如需使用其他模型，请使用标准的 MiniMax API 接口。

​
兼容性说明

​
支持的参数

在使用 AI SDK 接入时，我们支持以下输入参数：
参数支持状态说明
model完全支持支持 MiniMax-M2.7 MiniMax-M2.7-highspeed MiniMax-M2.5 MiniMax-M2.5-highspeed MiniMax-M2.1 MiniMax-M2.1-highspeed MiniMax-M2 模型
messages部分支持支持文本和工具调用，不支持图像和文档输入
maxTokens完全支持最大生成 token 数
system完全支持系统提示词
temperature完全支持取值范围 (0.0, 1.0]，控制输出随机性，建议取值 1
toolChoice完全支持工具选择策略
tools完全支持工具定义
topP完全支持核采样参数

​
Messages 字段支持

字段类型支持状态说明
role="user"完全支持用户文本消息
role="assistant"完全支持助手响应
role="tool"完全支持工具调用结果
type="text"完全支持文本内容
type="tool-call"完全支持工具调用
type="tool-result"完全支持工具调用结果
type="image"不支持暂不支持图像输入
type="file"不支持暂不支持文件输入

​
示例代码

​
流式响应

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

console.log("Starting stream response...\n");
console.log("=".repeat(60));
console.log("Thinking Process:");
console.log("=".repeat(60));

const result = streamText({
  model: minimax('MiniMax-M2.7'),
  system: 'You are a helpful assistant.',
  prompt: 'Hi, how are you?',
  onError({ error }) {
    console.error(error);
  },
});

let inText = false;

for await (const part of result.fullStream) {
  if (part.type === 'reasoning') {
    // 流式输出思考过程
    process.stdout.write(part.text);
  } else if (part.type === 'text') {
    if (!inText) {
      inText = true;
      console.log("\n" + "=".repeat(60));
      console.log("Response Content:");
      console.log("=".repeat(60));
    }
    // 流式输出文本内容
    process.stdout.write(part.text);
  }
}

console.log("\n");

​
注意事项

  1. AI SDK 兼容接口目前支持 MiniMax-M2.7 MiniMax-M2.7-highspeed MiniMax-M2.5 MiniMax-M2.5-highspeed MiniMax-M2.1 MiniMax-M2.1-highspeed MiniMax-M2 模型
  2. temperature 参数取值范围为 (0.0, 1.0]，超出范围会返回错误
  3. 当前不支持图像和文档类型的输入
  4. 默认的 minimax Provider 实例使用 Anthropic 兼容 API 格式。如需使用 OpenAI 兼容格式，请使用 minimaxOpenAI。
  5. 更多信息请参阅 MiniMax AI Provider on AI SDK 和 GitHub 仓库