MiniMax M2.5 是一个 2290 亿参数的稀疏混合专家模型，虽规模庞大但推理效率极高。由中国 AI 公司 MiniMax 发布，它在自主编码和网页导航任务中位列顶级开源模型，SWE-Bench Verified 得分 80.2%，BrowseComp 得分 76.3%。
Novita 提供加速版模型，在保持上一版本强劲性能的同时显著提升速度。
访问方式对比
| 方式 | 设置时间 | 成本（每日 100 万 Token） | 适用场景 |
|---|---|---|---|
| Web 在线体验 | 0 分钟 | 免费（有限速） | 首次评估、一次性任务 |
| Novita AI API | 2 分钟 | 输入：$0.3 /Mt 缓存读取：$0.03 /Mt 输出：$1.2 /Mt |
生产应用、中等流量、快速原型开发 |
| NovitaClaw | 5 分钟 | 输入：$0.3 /Mt 缓存读取：$0.03 /Mt 输出：$1.2 /Mt |
终端自动化、DevOps 工作流 |
| Claude Code | 5 分钟 | 输入：$0.3 /Mt 缓存读取：$0.03 /Mt 输出：$1.2 /Mt |
代码库探索、IDE 集成 |
| 本地部署（Q4_K_M） | 30–60 分钟 | 一次性投入：$60,000–$90,000 | 高流量生产、数据隐私要求 |
| 云 GPU | 5 分钟 | 8x GPU $11.60/小时 | 短期实验、突发工作负载、大型模型测试 |
1. Web 在线体验
最快的零门槛入口是 Novita AI 的 Web 在线体验——无需注册、无需 API 密钥，即刻评估。适合在决定 API 集成或本地部署之前快速测试能力。
典型场景： Prompt 工程、质量评估、编码任务测试、与其他模型并列对比输出。Web 在线体验非常适合首次评估和一次性任务——无需任何技术设置。
2. Novita AI API（推荐给大多数开发者）
为什么选择 Novita AI API？
- 兼容 OpenAI 和 Anthropic 接口
- 有竞争力的定价： 每 100 万 Token 仅 $0.30 / $1.20。
- 支持缓存定价： 缓存定价允许您重复使用之前保存的 Prompt，帮助减少重复计算并降低整体成本。
设置指南
第一步：登录并访问模型库
登录您的账户，点击 Model Library 按钮。
第二步：选择您的模型
浏览可用选项，选择适合您需求的模型。
第三步：开始免费试用
开始免费试用，探索所选模型的能力。
第四步：获取 API 密钥
为确保 API 认证，我们将为您提供一个新的 API 密钥。进入 “Settings” 页面，按图中所示复制 API 密钥。
第五步：安装 API
使用您所用编程语言的包管理器安装 API。
安装完成后，在开发环境中导入必要的库。使用您的 API 密钥初始化 API，开始与 Novita AI LLM 交互。以下是 Python 用户使用 chat completions API 的示例。
from openai import OpenAI
client = OpenAI(
api_key="<Your API Key>",
base_url="https://api.novita.ai/openai"
)
response = client.chat.completions.create(
model="minimax/minimax-m2.5",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello, how are you?"}
],
max_tokens=131100,
temperature=0.7
)
print(response.choices[0].message.content)
3. 命令行工具访问
NovitaClaw
NovitaClaw 是一个命令行工具，用于在 Novita Agent Sandbox 上部署和管理持久化的 OpenClaw 代理。通过一条命令，即可启动一个完全托管的代理实例，持续运行——无会话限制，无需手动重启。部署后，可以通过 CLI、Web UI 或外部自动化脚本等多种接口访问和控制代理。
快速入门
前置条件
在开始之前，请确保您已拥有：
- Python 已安装
- Novita API 密钥（在 密钥管理 中创建或管理）
第一步：安装 NovitaClaw
macOS / Linux：
sudo pip3 install novitaclaw
Windows PowerShell：
pip install novitaclaw
验证：运行 novitaclaw --help。如果看到命令列表，则表示安装成功。
第二步：设置 API 密钥
macOS / Linux：
export NOVITA_API_KEY=sk_your_api_key
Windows PowerShell：
$env:NOVITA_API_KEY = "sk_your_api_key"
第三步：启动实例
novitaclaw launch
成功后，CLI 会返回：
- Web UI 地址 — 与您的代理聊天
- Gateway WebSocket 地址和令牌 — 用于程序化访问
- Web 终端地址 — 基于浏览器的终端访问
- 文件管理器地址 — 管理工作区文件
- 登录凭证 — 用于 Web 终端和文件管理器
打开 Web UI 地址，进入 Chat 标签页，即可开始使用您的代理。
配置模型
您的实例默认预配置了 Novita 托管的模型。如需自定义：
前往：
Settings → Config → Raw (JSON5 view)
点击 “secrets redacted” 以显示完整配置。
第一步：注册模型
在 models.providers.novita.models 下添加新条目：
{
"models": {
"providers": {
"novita": {
"models": [
{
"id": "model-id",
"name": "display name",
"reasoning": true,
"input": ["text"],
"contextWindow": 200000,
"maxTokens": 50000
}
]
}
}
}
}
第二步：设为主模型或备用模型
更新 agents.defaults：
{
"agents": {
"defaults": {
"model": {
"primary": "novita/model-id",
"fallbacks": ["novita/fallback-model-id"]
}
}
}
}
Claude Code
Claude Code 是 Anthropic 官方推出的 CLI 代理，主要面向 Claude 模型设计，但同时兼容支持 Anthropic API 的端点（如 Novita AI）。它在全仓库分析、复杂调试和自主编码循环方面表现出色。
设置：
- 安装 Claude Code：
#macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
#Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
#Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
#Windows 需要 Git for Windows，请先安装。
- 设置环境变量：
# 设置 Novita 提供的 Anthropic SDK 兼容 API 端点。
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Novita API Key>"
# 设置 Novita 提供的模型。
export ANTHROPIC_MODEL="minimax/minimax-m2.5"
export ANTHROPIC_SMALL_FAST_MODEL="minimax/minimax-m2.5"
- 在您的项目中启动 Claude Code：
cd /path/to/project
claude .
适用场景： 代码库探索、多步调试、自主功能实现、通过终端插件集成 VSCode/Cursor。
4. 本地部署
MiniMax M2.5 的稀疏 MoE 架构（总参数 2290 亿，激活 100 亿）使得在高性能消费级硬件或多 GPU 配置上进行本地部署成为可能。该模型全精度 BF16 需要 457GB 显存，但通过 Unsloth 的 GGUF 量化可以缩小到 101GB（动态 3-bit）或 138GB（Q4_K_M）。
硬件要求
| 量化方式 | 所需显存 | 硬件示例 |
|---|---|---|
| BF16（全精度） | 457GB | 6× H100 80GB |
| Q8_0 | 243GB | 4× H100 80GB |
| Q6_K | 188GB | 3× H100 80GB |
| Q4_K_M（推荐） | 138GB | 2× H100 80GB |
| Q3_K_M | 109GB | 2× H100 80GB |
| UD-IQ2_XXS（最低） | 74GB | 单张 H100 80GB |
安装（llama.cpp）
git clone https://github.com/ggml-org/llama.cpp.git
cd llama.cpp
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j"$(nproc)"
# 如需安装 HF CLI
pip install -U "huggingface_hub[cli]"
# 下载指定量化版本（示例：Q3_K_M）
hf download unsloth/MiniMax-M2.5-GGUF \
--include "Q3_K_M/*" \
--local-dir ./models
# 检查文件
find ./models -name "*.gguf"
# 运行（使用第一个分片）
./build/bin/llama-cli \
-m ./models/Q3_K_M/MiniMax-M2.5-Q3_K_M-00001-of-00004.gguf \
-p "Write a Python function to check if a number is prime"
云 GPU 安装（高性价比）
第一步：注册账户
通过我们的网站创建您的 Novita AI 账户。注册后，在左侧边栏点击“Explore”查看我们的 GPU 产品，开始您的 AI 开发之旅。
第二步：探索模板和 GPU 服务器
选择符合您项目需求的模板，如 PyTorch、TensorFlow 或 CUDA。然后选择您偏好的 GPU 配置——可选 L40S、RTX 4090 或 A100 SXM4 等强劲选项，各有不同的显存、内存和存储规格。
第三步：定制部署
通过选择首选操作系统和配置选项，自定义您的环境，确保为特定的 AI 工作负载和开发需求提供最佳性能。
| 规格 | 计费方式 | GPU | 价格 |
|---|---|---|---|
| H100 80 GB 显存 | 按需 | 1x GPU | $1.45/小时 |
| 8x GPU | $11.60/小时 | ||
| 竞价 | 1x GPU | $0.73/小时 | |
| 8x GPU | $5.84/小时 |
Novita AI 的竞价实例 是一种成本优化的 GPU 租赁系统，利用平台闲置或未充分利用的 GPU 容量。与按需实例为稳定、持续使用而保留专用硬件不同，竞价实例是 可中断 的——如果 GPU 被系统回收，您的任务可能会暂停或终止。由于竞价模式重新分配原本空闲的 GPU 资源，其价格通常比按需定价低 40%–60%。
MiniMax M2.5 提供了四种实用的访问路径，每种都针对不同场景进行了优化。对于大多数开发者而言，Novita AI 的 API 每百万 Token 仅需 $0.30/$1.20，是通往生产环境的最快路径——设置仅需 2 分钟，且兼容 OpenAI SDK。Web 在线体验适合首次评估，OpenClaw CLI 和 Claude Code 则为高级用户提供终端集成的代理工作流。自托管仅在每日 Token 量超过 1000 万或严格的数据隐私要求禁止云端 API 时才有经济意义——此时 Q4_K_M 量化配合 2× H100 80GB 可提供生产级性能。
常见问题
MiniMax M2.5 与其他编码模型有何不同？
MiniMax M2.5 采用稀疏 MoE 架构，总参数量 2290 亿，但每个 Token 仅激活 100 亿，SWE-Bench Verified 得分达 80.2%，成本仅为 Claude Sonnet 4.5 的 8%。
我能在单张消费级 GPU 上运行 MiniMax M2.5 吗？
不能——即使采用激进的量化，最低显存要求仍为 74GB。
MiniMax M2.5 是否支持函数调用和结构化输出？
是的——MiniMax M2.5 通过兼容 OpenAI 的 API 格式支持函数调用。
Novita AI 是一个 AI 与代理云平台，帮助开发者和初创企业以高性能、高可靠性和高成本效率构建、部署和扩展模型及代理应用。
推荐阅读
