MiniMax API 的官方接入地址分国内版与国际版两套,国内基址为 api.minimaxi.com,国际基址为 api.minimax.io,两者都兼容 OpenAI 与 Anthropic 协议。注册开放平台账号、创建 API Key 后即可按量调用 MiniMax-M3、M2.7 等模型。下文整理入口、密钥、价格与报错等要点。
MiniMax 开放平台官方入口
- 开放平台(国内):platform.minimaxi.com,文档、控制台与密钥管理都在这,面向国内开发者,按量计费以人民币结算。
- API 接入地址(国内):api.minimaxi.com,OpenAI 兼容路径为 /v1/chat/completions,Anthropic 兼容路径为 /anthropic/v1/messages。
- 开放平台(国际):intl.minimaxi.com,文档同位于 platform.minimax.io,面向海外业务,API 基址为 api.minimax.io,按美元计费。
- 旧版文本接口:api.minimax.chat/v1/text/chatcompletion_v2,仅对应 MiniMax-Text-01 模型,新项目建议直接用上述新域名。
注意区分:国内版与国际版的账号体系、计费币种、文档站相互独立,调用时基址和 Key 要配套,混用会直接返回鉴权错误。
API Key 怎么获取与配置
- 打开对应的开放平台站点,用手机号或邮箱完成注册并登录;
- 进入「账户管理 → API Keys」,点击创建密钥;
- 密钥仅在创建时完整显示一次,页面关闭后无法再次查看,请立即复制到服务端环境变量,切勿写进前端代码或提交到代码仓库;
- 在请求 Header 中加入 Authorization: Bearer <你的Key>,Content-Type 设为 application/json;
- 发起首次调用前确认账户余额充足,按量计费账户余额为零会直接返回余额不足报错,需要先充值。
支持的模型与价格一览
截至 2026 年 9 月核查,以下为国内站按量计费的公开单价(永久五折后,单位:元 / 百万 tokens)。国际站以美元计价,M3 标准档约为输入 $0.30、输出 $1.20(每百万 tokens),Priority 档为标准档 1.5 倍,长上下文(>512K 输入)再翻倍,可在控制台用量页核对当期标准:
M2-her 专用于对话与角色扮演场景,上下文 64K;高速版(highspeed)输入输出价格翻倍、生成速度更快。表中价格均为永久五折后的实际结算价,原价约为上表数值的两倍。
按量计费与额度规则
MiniMax API 采用预付费的按量计费模式:先在开放平台钱包充值,调用时按实际消耗的 token 数扣减,余额不足即停止服务。账户通常区分「充值余额」与「赠送余额」,扣费时优先消耗赠送部分,用完再扣充值余额。具体免费额度、赠送政策与新用户权益会随官方活动调整,以控制台账单页的当期说明为准。token 与实际字符数并非一一对应,最终以接口返回的 usage 字段为准。
常见报错与排查办法
| | | |
|---|
| | | 检查 Key 是否完整、是否混用了国内/国际站点,确认 Header 写法 |
| | | |
| | | |
| | | |
| | | |
| | | 稍后重试,持续报错可附 request_id 联系技术支持 |
新手常见问题
Q:MiniMax API 免费吗? A:开放平台注册和部分模型有试用额度,正式调用按 token 计费,超出免费部分需先充值。
Q:国内版和国际版地址能混用吗? A:不能。两套账号、密钥与基址相互独立,国内 Key 只能调到 api.minimaxi.com,用错站点会报 401。
Q:支持 OpenAI SDK 直接调用吗? A:支持。把 OpenAI 客户端的 base_url 改成 api.minimaxi.com/v1(或 api.minimax.io/v1)、填入 MiniMax Key 即可,不用换 SDK。
Q:API 官方入口在哪里? A:文档与控制台都集中在开放平台官网,密钥在「账户管理 → API Keys」创建,入口只有官方这一个。
Q:MiniMax-M3 和 M2.7 怎么选? A:要做长文档、Agent 或多模态任务选 M3(1M 上下文);常规对话和高并发选 M2.7,性价比更高。
Q:常见报错 401 怎么解决? A:多是 Key 复制不全或站点配错,重新复制完整 Key 并确认 base_url 与账号区域一致。
Q:需要企业资质或实名吗? A:个人开发者用手机号或邮箱即可注册调用,企业批量用量可在控制台升级账户类型。
Q:单次或每日调用有上限吗? A:平台按账户套餐和模型设有限流,具体 RPM 与并发额度随套餐变化,可在控制台或文档查看当期标准。
Q:API Key 和我的数据隐私安全吗? A:Key 应只保存在服务端并定期轮换,请求内容按平台隐私政策处理,不要在客户端代码或公开仓库暴露密钥。
MiniMax API 接入地址按国内、国际两套基址区分,弄清 api.minimaxi.com 与 api.minimax.io 的对应关系,再配好 Key 和余额,就能顺手接上 MiniMax-M3 等模型。想跟进 MiniMax API 的模型更新与价格变动,可以关注本站的 AI 工具栏目,有新版本我们会同步更新。