MiniMax M3 订阅购买与 API Key 接入教程(2026最新)
从 Token Plan 订阅、Credits 充值、API Key 区分到 MiniMax-M3 首次调用的完整流程
BLUF 摘要(点开查看)
这篇教程用 6 个步骤说明 MiniMax M3 API 如何注册、开通、获取 API Key 并完成首次接入;先确认国内直连、免费额度、计费单位,再把 Key 安全保存到环境变量或工具配置中。
教程概览
确认 MiniMax M3 的购买方式
MiniMax 现在同时提供 Token Plan 订阅、Credits 预付余额和 Pay-as-you-go 按量计费。购买前先决定你要用哪一种 Key,避免把不同计费体系混在一起。
点击位置:先阅读官方 Pricing / Token Plan 页面,再决定订阅还是按量计费
完成后看到:能分清 Subscription Key 与 Pay-as-you-go API Key 的用途
- 如果工具提示鉴权失败,先检查当前填的是 Token Plan Key 还是 Pay-as-you-go API Key
- 如果没有可用额度,确认 Token Plan 是否已购买或 Credits 是否已到账

- Token Plan:适合个人开发者、小团队和 AI Coding 工具,按月获得共享额度
- Credits:预付余额,和 Token Plan 使用同一类 Subscription Key,可覆盖额度溢出
- Pay-as-you-go:标准 Open Platform API Key,按实际 token 或调用扣账户余额
- Token Plan Key 和 Pay-as-you-go API Key 不是同一个体系,不能混用
注册并登录 MiniMax 开放平台
进入 MiniMax 开放平台后完成登录。中国大陆用户通常可使用手机号或微信登录,国际用户可使用邮箱登录。
点击位置:浏览器访问 platform.minimax.io → 登录
完成后看到:进入 MiniMax 控制台,能看到 API、Billing 或 Token Plan 相关入口
- 验证码是否能正常接收
- 微信扫码是否完成确认
- 登录后看不到控制台时尝试刷新或更换 Chrome/Edge

- 访问 MiniMax 开放平台:platform.minimax.io
- 点击登录入口,选择手机号、邮箱或微信扫码登录
- 登录后进入控制台,确认账号状态正常
- 如页面语言或价格口径与你预期不同,先检查账号地区和控制台页面
订阅 Token Plan 或充值 Credits
如果你主要用 M3 做编程 Agent、长上下文或多模态任务,优先看 Token Plan;如果只是临时补额度,可以看 Credits。
点击位置:控制台 → Billing / Token Plan → 选择 Plus、Max 或 Ultra → Subscribe / Purchase
完成后看到:订阅状态显示为 active,控制台能看到可用额度或 Credits 余额
- 支付失败时更换支付方式或检查网络
- 支付后未生效可刷新页面或重新登录
- 如 5-10 分钟仍未到账,保留支付凭证联系官方客服

- Token Plan 入口:platform.minimax.io/subscribe/token-plan
- 官方 M3 发布页给出的 2026-06-01 口径:Plus $20/月约 1.7B M3 tokens,Max $50/月约 5.1B,Ultra $120/月约 9.8B
- 你提供的订阅教程里还记录了人民币区域口径:Plus 约 49 元/月、Max 约 119 元/月、Ultra 约 469 元/月
- 订阅或充值后在 Billing / Token Plan 页面查看额度条、到期时间和可用资源
- MiniMax 官方文档说明,Token Plan 的文本、图像、语音、音乐等资源共享同一额度池
获取正确的 Key
MiniMax 官方文档把 Pay-as-you-go API Key 和 Token Plan Subscription Key 分开。接入前先确认你的工具要用哪一种。
点击位置:Pay-as-you-go:API Keys → Create new secret key;Token Plan:Billing → Token Plan → Get API Key
完成后看到:得到一串可复制的 Key,并明确它属于 Token Plan 还是 Pay-as-you-go
- Key 复制后是否保存
- 工具里的 Base URL 是否和 Key 类型匹配
- 如果调用 401/403,先换正确的 Key 类型再排查余额

- Pay-as-you-go:进入 API Keys 页面,点击 Create new secret key
- Token Plan:进入 Billing / Token Plan 页面,查看或复制 Subscription Key
- Token Plan Key 通常用于 OpenClaw、Claude Code、Cline、Codex 等 AI Coding 工具
- Pay-as-you-go API Key 用于标准 Open Platform API,按实际用量扣账户余额
- 复制后立即保存到密码管理器或 .env 文件,不要发到聊天窗口或提交到 GitHub
配置 MiniMax-M3 并首次调用
MiniMax 官方推荐 Anthropic SDK,同时也支持 OpenAI 兼容接入。M3 的官方模型名为 MiniMax-M3。
点击位置:终端安装 anthropic,设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 后运行测试脚本
完成后看到:终端成功打印 MiniMax-M3 的文本回复,无鉴权或模型名错误
- 确认模型名是 MiniMax-M3
- 确认 ANTHROPIC_BASE_URL 为
https://api.minimax.io/anthropic - 确认 Key 仍有效且有额度
- 如超过上下文或请求体限制,先缩短输入再试

- Anthropic 兼容 Base URL:
https://api.minimax.io/anthropic - OpenAI / Responses 兼容 Base URL:
https://api.minimax.io/v1 - 模型名填写 MiniMax-M3
- M3 支持最高 1,000,000 token 上下文,官方建议把 512K 以内作为常规长上下文区间
- M3 支持 thinking、工具调用、图像和视频输入;M2.7/M2.5/M2.1 主要支持文本和工具调用
# pip install anthropic
# macOS/Linux:
# export ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic
# export ANTHROPIC_API_KEY=你的_MINIMAX_KEY
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="MiniMax-M3",
max_tokens=1000,
system="You are a helpful assistant.",
messages=[
{
"role": "user",
"content": [{"type": "text", "text": "你好,请用一句话介绍 MiniMax M3。"}],
}
],
)
for block in message.content:
if block.type == "text":
print(block.text)按 M3 价格和上下文长度控制成本
M3 的 API 价格会根据输入长度和服务等级变化。普通对话和大部分编程任务优先控制在 512K 输入以内。
点击位置:控制台 → Usage / Billing / Token Plan
完成后看到:能看到本月用量、剩余额度和是否触发 Credits 或 Pay-as-you-go 扣费
- 大仓库/长视频/超长文档是否触发 >512K 长上下文价格
- 是否误用 Priority 通道
- 是否把 Token Plan 额度用完后开始扣 Credits 或 PAYG 余额

- MiniMax-M3 标准通道:上下文 ≤512K 时,输入 ¥2.1/百万 tokens、输出 ¥8.4/百万 tokens、缓存读取 ¥0.42/百万 tokens
- MiniMax-M3 标准通道:上下文 512K~1M 时,输入 ¥4.2/百万 tokens、输出 ¥16.8/百万 tokens、缓存读取 ¥0.84/百万 tokens;超过 512K tokens 的能力限时限量供应,如需使用请联系销售
- MiniMax-M2.7:输入 ¥2.1/百万 tokens、输出 ¥8.4/百万 tokens、缓存读取 ¥0.42/百万 tokens、缓存写入 ¥2.625/百万 tokens;MiniMax-M2.7-highspeed 输入 ¥4.2/百万 tokens、输出 ¥16.8/百万 tokens、缓存读取 ¥0.42/百万 tokens、缓存写入 ¥2.625/百万 tokens
- M3 可切换 thinking 开关;复杂 Agent/推理任务开启 thinking,低延迟对话和补全可关闭 thinking
- 用量统计页面定期查看 token 消耗、额度条和 Credits 余额
配置推荐:使用 CC Switch 接入 AI 工具
创建 API Key 后,建议用 CC Switch 统一填写 API Key、Base URL 和模型名称,再接入 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具,避免手动修改配置文件出错。
使用提示
购买前先决定:Token Plan 用于个人/小团队固定额度,Pay-as-you-go 用于企业或按量接入
MiniMax-M3 适合代码、Agent、长上下文、多模态输入和 AI Coding 工具
Token Plan Key 和 Pay-as-you-go API Key 不要混用,出错时先检查 Key 类型
M3 的 1M 上下文很适合仓库级分析,但超过 512K 输入可能触发更高价格
如果你要接入 Codex、Claude Code、Cline、OpenClaw 等工具,优先看 MiniMax 官方的 AI Coding Tools 文档
注意事项
不要在前端、公开仓库、截图或聊天记录中暴露 MiniMax Key
MiniMax M3 发布初期价格、折扣、Key 类型和工具适配变化很快,正式采购前必须复查官方控制台
适合谁
- • 国内用户,想快速接入 AI API
- • 需要手把手指导完成注册、充值和获取 Key 的新手
- • 想把 MiniMax M3 接入 Claude Code、Codex 等工具的用户
常见问题
MiniMax M3 有免费额度吗?
有,Token Plan / Credits / Pay-as-you-go 以官方控制台为准。建议先用免费额度测试真实任务,确认满足需求后再充值。
注册 MiniMax M3 需要什么?
手机号或邮箱即可注册,支持支付宝/微信充值。部分 API 需要实名认证。
API Key 泄露了怎么办?
立即到控制台删除泄露的 Key 并重新生成。建议把 Key 存在环境变量或 .env 文件中,不要提交到 Git 仓库。