MiniMax 的 API Key 有两个常见来源：MiniMax 开放平台，以及中商起航 AI 网关这类兼容入口。两者都能调用模型，但注册入口、Key 的作用范围和账单是分开的。本文按实际操作顺序，讲清注册、创建、保存、权限隔离、轮换和 401 排查，最后给出官方 Key 与网关 Key 的选择建议。

第一次接入的团队，先记住一句话：Key 不是越万能越好，而是按环境、按人、按用途拆开，能停用、能追踪、能替换。这样即使某一把 Key 出问题，也不会影响全部业务。

说明：MiniMax 是其权利人的商标，本文仅作技术说明。平台入口、Key 管理方式和限额以 MiniMax 官方文档及控制台为准；模型与计费口径以站内 模型价格 为准。

一、先分清三种 Key

MiniMax 官方目前常见两类 Key：按量付费的接口密钥，以及 M Plan 订阅对应的订阅 Key。前者在账号的「接口密钥」页面创建，支持语言、视频、语音、图像等模型；后者在订阅与账单页面查看，用于 M Plan 订阅和已购买的 Credits。第三类是中商起航 AI 网关的 Key，它只在网关内有效，用于统一调用已开通的多个模型。

三类 Key 不要混用。最常见的事故，是把官方 Key 填到网关地址，或者把网关 Key 发到官方接口，然后反复检查代码，最后发现只是地址和 Key 不匹配。

Key 类型 创建或查看位置 作用范围 适合场景
官方按量付费 Key 开放平台「接口密钥」 官方账号下已开通的模型与接口 只接 MiniMax、直接与官方结算
官方 M Plan 订阅 Key 订阅与账单页面 M Plan 订阅及已购 Credits 已购买订阅、按套餐使用
网关 Key 中商起航控制台 网关内已开通的模型 多模型统一入口、统一账单

二、注册：先确认中国站还是国际站

MiniMax 有中国站和国际站两套入口：platform.minimax.cn 与 platform.minimax.io。两边的入口、控制台和 Base URL 不同，注册前先确认团队能访问哪一个、结算方式适合哪一个。不要在中国站注册，却把 Key 配到国际站地址上。

团队使用建议采用「主账号 + 子账号」。中国站文档说明，主账号可以创建子账号，子账号共享主账号的权益、限流和 API 消费与账单，但不能查看和管理付款。这样每个人有自己的登录身份，离职时停用子账号即可，不必把主账号密码传来传去。

如果控制台要求补充企业信息或验证方式，按页面提示完成，以注册时看到的流程为准。

三、创建 Key 的步骤

  1. 登录 MiniMax 开放平台，进入用户中心的「接口密钥」页面。中国站路径是 platform.minimax.cn/user-center/basic-information/interface-key。
  2. 点击新建或创建密钥，名称写清楚用途，例如 prod-customer-service 或 test-zhang。
  3. 按页面提示选择或确认可用范围。如果页面没有提供模型级权限选项，说明当前以账号权限为主。
  4. 创建后立即复制 Key，保存到密码管理器或密钥管理服务。不要截图发群，不要写进代码注释。
  5. 如果使用 M Plan，订阅 Key 不在接口密钥页，而在订阅与账单页面查看。
  6. 用一条最小请求验证 Key 是否可用，确认地区、Base URL 和模型名都匹配。
  7. 在团队台账里记录 Key 的负责人、用途、创建日期和停用条件。

第 3 步要特别说明：从公开文档看，官方没有给出「按模型细分 Key 权限」的通用说明，实际以控制台显示为准。如果需要隔离不同业务，优先用子账号或不同环境的独立 Key，而不是指望一个 Key 管所有事。

四、权限隔离：一个环境一个 Key

至少拆成三类：开发、预发布、生产。生产 Key 只放在服务端环境变量或密钥管理服务里，不下发到浏览器、移动端和桌面客户端。测试 Key 可以设置更低的额度，方便随时停用。

如果团队有多条业务线，再按业务拆 Key：客服一个、内容生成一个、批处理一个。这样某条业务异常时，能单独停用，不影响其他业务；看用量时也更容易定位。

权限隔离的目标不是增加手续，而是让故障有边界；一个 Key 服务所有业务，短期省事，长期难排查。

五、把 Key 放进环境变量

不要把 Key 写进代码。下面是最小示例，.env 只用于本地，生产环境用平台的密钥管理或容器 Secret。

# .env（不要提交到 Git）
MINIMAX_API_KEY=你的密钥
# 官方中国站示例；走网关时替换为网关地址和站内模型名
MINIMAX_BASE_URL=https://api.minimax.cn/v1
MINIMAX_MODEL=MiniMax-M3.1-Flash

# .gitignore
.env
.env.*

Python 里用 os.environ["MINIMAX_API_KEY"] 读取，不要把 Key 作为默认值写进函数参数。注意三点：第一，.env 必须加入 .gitignore；第二，容器和 CI 里不要把 Key 打进镜像层；第三，日志里打印请求头时先脱敏，避免把 Authorization 写进日志。

如果使用密钥管理服务，给应用分配只读权限，并记录每次读取。不要把 Key 复制到聊天工具或文档正文里。

六、轮换与泄露处理

官方文档没有规定固定的轮换周期，建议按风险自己定：核心生产 Key 每 90 天轮换一次，人员变动、设备丢失、疑似泄露时立即轮换。

轮换按「先建新、再切换、后停旧」的顺序：

  • 创建新 Key，命名带日期，例如 prod-2026-10。
  • 把新 Key 写入密钥管理，先在预发布验证。
  • 灰度切换生产流量，观察错误率和用量。
  • 确认稳定后停用旧 Key，保留操作记录。
  • 检查旧 Key 在停用前是否有异常调用。

如果怀疑泄露，不要只改代码里的字符串。立即在控制台停用或删除该 Key，创建新 Key，检查账单和调用日志，必要时联系平台支持。官方文档也提到，公开泄露的 Key 可能被平台自动停用，但不能把自动停用当成兜底。

七、401 排查：先看地址，再看 Key

401 表示认证失败，不等同于余额不足或限流。按下面顺序排查：

  • 请求头是否是 Authorization: Bearer <Key>，Bearer 和 Key 之间有一个空格。
  • Key 是否复制完整，前后有没有空格、换行或引号。
  • 中国站 Key 是否配了中国站地址，国际站 Key 是否配了国际站地址。
  • 官方 Key 是否误填到网关地址，或网关 Key 是否误填到官方地址。
  • Key 是否已被删除、停用，或属于已失效的订阅。
  • 环境变量是否真的加载成功。在容器里打印变量名，不要打印变量值。

如果返回 403，通常是权限或额度问题；429 是限流；insufficient balance 一类信息才指向余额。把 401 和这些错误分开处理。

八、官方 Key 与网关 Key 怎么选

只使用 MiniMax、能直接完成官方注册和结算、团队也有能力分别管理各家 Key，官方直连更简单。需要同时接 MiniMax、Claude、GPT、DeepSeek 等多个模型，或者希望一个 Key、统一账单、统一用量视图，网关更省事。

网关的代价是多一层依赖，所以要确认三件事：支持哪些 MiniMax 模型、计费口径是否清楚、出问题时的支持渠道。先小额测试，再放生产流量。可以到 模型价格 核对模型与计费，然后从 注册入口 创建测试 Key。

常见问题

MiniMax API Key 在哪里创建？

官方按量付费 Key 在开放平台的用户中心「接口密钥」页面创建；M Plan 的订阅 Key 在订阅与账单页面查看。具体路径以你所在站点的控制台为准。

一个 Key 可以同时调用文本、语音和视频吗？

官方按量付费的接口密钥支持语言、视频、语音、图像等多类模型，但是否可用取决于账号权益、模型开通情况和接口类型。语音、视频多为异步任务接口，不能直接套用聊天接口。

Key 可以放在前端或小程序里吗？

不可以。前端代码、浏览器请求和小程序包都可能被反编译或抓包。Key 只能放在服务端，由服务端代理请求；如果必须直连，使用短期令牌或受限权限，并接受 Key 可能泄露的风险。

轮换 Key 需要停机吗？

不需要。先创建新 Key，在预发布验证，再灰度切换生产，最后停用旧 Key。关键是新旧 Key 有一段并存时间，避免切换瞬间全部失败。

官方 Key 和网关 Key 能混用吗？

不能。两边的 Key 只在各自的平台和地址内有效。混用通常表现为 401 或 404；先检查 Base URL 和 Key 是否来自同一个平台。

下一步

先明确你只需要 MiniMax，还是需要多模型统一入口。只用一个模型，按官方文档创建 Key 即可；需要统一入口，可以先 注册中商起航 AI 网关，创建一个测试 Key，再用 模型价格 页核对模型和计费。无论选哪种，记得把 Key 放进环境变量，并给测试和生产分开。

相关阅读：