MiniMax M3 使用教程：从入门到上手

MiniMax M3 是什么

MiniMax M3 是 MiniMax 公司最新开源的大模型，主打编程能力、超长上下文和原生多模态。在 SWE-Bench Pro 评测中拿到 59 分，官方声称这个成绩超过了 GPT-5.5、接近 Claude Opus 的水平。对国内开发者来说，它最大的优势是完全可用——不需要任何网络工具，直接注册就能用 API 或在线体验，代码和模型权重也开放了，可以本地部署。

核心功能怎么用

1. 写代码与 SWE-Bench 能力
M3 在软件工程任务上表现突出，能直接处理 GitHub issue 级别的代码修改。比如你给它一个 bug 描述，它能定位到具体文件、生成补丁、甚至跑测试。实际使用时，把代码上下文和需求一并发给 API，它返回的就是可直接应用的代码块。官方推荐用 system 角色设定为“资深工程师”，效果最好。

2. 100 万 token 上下文
这是 M3 的亮点。它用原生稀疏注意力机制，可以一次性处理整份项目代码或几百页文档。比如把整个 Spring Boot 项目源码喂进去，然后问“这个模块的依赖关系是什么”，它都能回答。注意：上下文越长，响应时间会稍慢，但不会像传统模型那样直接崩溃。

3. 原生多模态与开源
M3 支持文本+图像混合输入，比如你传一张架构图，再问“这个架构哪里容易出问题”，它能结合图片理解。权重已开源（GitHub 可搜 MiniMax-M3），可以在自己的服务器上跑，适合数据敏感的场景。

第一次上手步骤

在线体验（最快）

1. 打开 MiniMax 官网，注册账号（国内手机号即可）。
2. 在“模型广场”找到 M3，直接输入问题测试。比如贴一段报错代码，问“修复这个 bug”。
3. 如果需要长上下文，在“高级设置”里调 max_tokens 为 1000000。

API 调用（推荐）

1. 进入控制台，创建 API Key（免费额度 100 万 token）。
2. 用 Python 调用（官方 SDK 已发布）：

from minimax import MiniMax  
client = MiniMax(api_key="你的key")  
response = client.chat.completions.create(  
    model="minimax-m3",  
    messages=[  
        {"role": "system", "content": "你是一个资深软件工程师"},  
        {"role": "user", "content": "解释这段代码的时间复杂度：\n```python\ndef foo(n):\n    for i in range(n):\n        for j in range(n):\n            print(i*j)\n```"}  
    ],  
    max_tokens=4096  
)  
print(response.choices[0].message.content)  

3. 如果想测试多模态，把图片转为 base64 放 messages 里即可。

本地部署（进阶）
从 GitHub 下载权重，用 transformers 加载。注意需要至少 32GB 显存的 GPU（比如 A100 或 4090 双卡）。官方提供了 Docker 镜像，按 README 跑即可。

适合什么场景

• 大型代码库维护：M3 的 100 万 token 能装下整个微服务项目，直接问“这个接口的调用链是什么”，省去翻代码的麻烦。
• 复杂 Bug 修复：把报错日志、相关代码、预期行为一起给 M3，它经常能定位到非明显错误（比如多线程竞态条件）。
• 技术文档分析：把几百页的 API 文档或论文丢进去，让它总结或提取关键点。
• 本地化部署需求：企业数据不出网，用开源权重自建服务，适合金融、医疗等合规行业。

价格说明

MiniMax M3 有免费额度：注册即送 100 万 token（输入+输出合计），有效期 30 天。超出后按量计费：

• 输入：0.002 元/千 token（约 100 万 token 2 元）
• 输出：0.008 元/千 token
  对比 GPT-4o 的输入 0.03 元/千 token，M3 便宜很多。如果只是个人写代码、查文档，免费额度够用很久。企业用户建议买包年套餐（联系销售），单价更低。注意：没有海外信用卡问题，国内支付宝/微信直接充。