MiniMax 开放平台的官网入口是 platform.minimaxi.com（中国内地）与 platform.minimax.io（海外），手机号注册并完成实名后即可获取 API Key。平台覆盖语言、语音、视频、音乐、图像五类模型；截至 2026 年 9 月，旗舰模型 MiniMax-M3 按量价标注"永久五折"，实际执行 2.1 元/百万输入 tokens。本文整理官网入口、Key 获取、全模态计费对照、充值规则与高频报错码。 minimax api开放平台的官网入口有哪些
MiniMax 的官方入口按区域和用途分成三组，注册前先分清，否则容易遇到 Key 与接口区域不匹配的 401：
- 中国内地开放平台：platform.minimaxi.com —— 手机号注册、实名认证后使用，API 地址为 https://api.minimaxi.com/v1（OpenAI 兼容）与 https://api.minimaxi.com/anthropic（Anthropic 兼容）。
- 海外 Global 平台：platform.minimax.io —— 面向海外账户，对应 https://api.minimax.io/v1 与 https://api.minimax.io/anthropic。
- 官网与消费级产品： www.minimaxi.com—— 公司官网（模型介绍、新闻、投资者关系）；海螺视频、星野等 C 端产品与开发者 API 是两套体系，账号和额度互不相通。
注意区分：内地与海外的 API Key 不通用，服务区域以购买平台为准，内地 Key 配 minimaxi.com、Global Key 配 minimax.io，混用会直接鉴权失败。官方文档目录在 platform.minimaxi.com/docs，错误码表在 docs/api-reference/errorcode。
minimax 开放平台注册与 API Key 获取步骤
- 打开 https://platform.minimaxi.com 点击注册，用手机号 + 验证码创建账号，并按提示完成实名认证（个人或企业均可，语音克隆功能强制要求实名）。
- 登录后在左侧菜单进入"账户管理 > 接口密钥"（部分版本路径为"API Keys"），点击"创建新的 API Key"并命名。
- 复制生成的 sk-... 密钥。API Key 只在生成时完整显示一次，官方不会再次展示，丢失只能删除重建，务必立即存入 .env 或密码管理器。
- 按需充值：进入"账户管理 > 余额"，按量付费用户先充值再调用；如购买 Token Plan 订阅，则需在"订阅管理 > Token Plan"复制独立的订阅 Key（普通 API Key 与订阅 Key 不是一回事，消耗不同的账户资源）。
- 配置调用地址：OpenAI SDK 用户把 base_url 设为 https://api.minimaxi.com/v1；官方也提供 Anthropic 兼容路径（https://api.minimaxi.com/anthropic），文档明确推荐用 Anthropic 兼容接口调用其高阶模型能力。
企业团队建议采用"主账号 + 子账号"：主账号注册时填写的姓名与手机号成为管理员信息，可创建不限数量的子账号分配员工使用；子账号与主账号共享用量、统一结算，但不能查看和管理支付页，也不能管理子账号的密钥。
minimax 语言模型价格：M3、M2.7 计费对照
以下为官方按量计费价目（核查时间 2026 年 9 月 9 日，单位人民币/百万 tokens）。MiniMax-M3 标注"永久五折"，每格前为标准价、后为折后执行价：
| | | |
|---|
| | | |
| | | |
| | | |
| | | |
MiniMax-M2 / M2.1 / M2.5（历史） | | | |
换算参考：官方估算约 1600 个中文字符消耗 1000 tokens（英文约 750 词/1000 tokens），实际以账单为准。三个省钱关键点：
- "上下文悬崖"：M3 宣称 1M 上下文，但价格并非全程一致——输入超过 512k tokens 后输入、输出、缓存读取价全部翻倍。喂超长文档前先算清楚 token 落在哪个区间。
- 加急是要加钱的：M3 的优先服务（请求体设 service_tier: priority）按标准价 1.5 倍计费；M2.7 则有独立的 -highspeed 型号，按 2 倍价计费。没有低延迟硬需求就别开，纯加价。
- 缓存读写分开算：重复前缀走缓存读取能省约 80% 输入成本，但首次写入缓存要付 2.625 元/百万 tokens（高于普通输入价 2.1 元），前缀读不回来几次反而更贵。
minimax 语音视频音乐图像 API 怎么计费
非文本模型各有独立的计费单位，不能套用 token 单价。官方价目如下（人民币，核查时间同前）：
| | | |
|---|
| Speech-to-Text（ASR，支持流式与说话人分离） | | |
| | | |
| | | |
| 音色设计 Voice Design / 快速复刻 Voice Cloning | | |
| | | |
| | | |
| MiniMax-Hailuo-2.3 / Hailuo-02 | | 768P 6s 2.00；1080P 6s 3.50 |
| | | |
| | | |
| | | |
语音按字符计费时注意：1 个汉字算 2 个字符，英文与标点各算 1 个字符；异步长文本合成单次最多支持 100 万字符。音乐 API 有重大政策变动：自 2026 年 8 月 20 日起，付费音乐生成与歌词接口不再面向新用户开放，免费接口（Music-3.0-free 等）已停止服务，官方建议改用 MiniMax Audio 产品或在 Hugging Face、魔搭社区下载其开源的 Music 3 模型。视频输入素材方面，图片 5 张以内免费、超出按 0.20 元/张，音频输入免费，视频输入按生成分辨率时长计费。 minimax 的计费模式与充值规则
- 两种计费体系、两把钥匙：按量计费用普通 API Key，消耗账户充值余额，所有模态均可调用；Token Plan 是月订阅（含订阅 Key 与独立积分余额），按固定额度包月使用。两把 Key 不可互换。
- 充值：按量用户在控制台"账户管理 > 余额"页充值后即可消费；官网定价页对未充值账户直接显示"立即充值"入口。
- Token Plan 的规则：据第三方监测站 2026 年 8 月的观察，订阅额度受 5 小时滚动窗口与每周窗口双重约束，当月未用完的额度不结转下期；不同档位对视频等资源的每日配额也不同。具体档位与额度请以官方"订阅管理 > Token Plan"页实时展示为准。
- 主/子账号共享结算：企业主账号创建的子账号共用额度、统一结算，但子账号无法管理支付与密钥。
minimax API 限流与常见报错速查
MiniMax 有独立错误码体系（官方错误码表见 docs/api-reference/errorcode），排查时先看 HTTP 状态码，再看响应体里的业务错误码。官方建议反馈问题时附上 Header 中的 trace_id。高频错误码如下：
| | |
|---|
| 无效 API Key / 未授权或 Token 不匹配 | 核对 Key 与接口区域（内地 Key 配 minimaxi.com、海外 Key 配 minimax.io），检查请求头与 .env 是否残留旧值 |
| | 检查账户余额或 Token Plan 资源，充值后再重试 |
1002 / 1041 / 2045（对应 HTTP 429） | | 降并发、加指数退避，避免请求骤增骤减；仍超限可联系平台提升配额 |
| | 对照端点文档检查模型名、消息角色、工具 schema、媒体文件 id |
| | |
| | |
| | |
| | |
1000 / 1001 / 1024 / 1033 | | 属临时性故障，退避重试，持续失败联系 api@minimaxi.com |
限流参考（据第三方监测站 2026 年 8 月 26 日对官方限流表的转述）：MiniMax-M3 为 200 RPM / 1000 万 TPM，M2.7 及更早型号为 500 RPM / 2000 万 TPM；语音合成与音色克隆约 60 RPM、音色设计 20 RPM、图像生成 10 RPM。视频接口中，历史 Hailuo V1 免费档 5 RPM / 付费档 20 RPM，新模型 MiniMax-H3（V2 接口）免费档 2 个并发任务 / 付费档 15 个。
使用 minimax API 要注意什么
- 定价有"前科"，促销会变：2026 年 5 月底 M3 发布时刊例价定为输入 4.2 元、输出 16.8 元（较 M2 系贵一倍），配套订阅从 29 元/月涨至 49 元/月、部分计费从按次改为按 token，因缺乏提前通知引发开发者社区集中吐槽，有用户测算实际涨幅约 257%，黑猫投诉平台也出现相关案例；此后官方按量页对 M3 标注"永久五折"，执行价回落至与 M2 系持平。做长期成本预算时，建议按刊例价而非折后价测算。
- Key 泄露会被自动禁用：官方明确警告不要把 Key 放进浏览器端代码或公开仓库，检测到公开泄露可能自动吊销。生成后只显示一次的密钥务必先落盘再使用。
- 语音克隆强制实名：Voice Cloning 与音色设计需要完成账户身份认证，个人开发者不要拿企业认证的账号去做个人用途的实名切换。
- 音乐 API 对新手关闸：2026 年 8 月 20 日后注册的账户无法使用付费音乐生成接口，想调音乐 API 前先确认自己的账户注册时间是否符合资格。
- 订阅不等于全模型通用：据第三方观察，Token Plan 的覆盖范围可能排除新一代视频模型（MiniMax-H3）、音色设计与音乐生成，超出的调用需单独按量付费。
- 实名与合规：内地平台要求实名注册，企业数据与跨境调用场景请先评估自身合规要求；企业客户可走主/子账号体系做权限隔离。
minimax api开放平台常见问题
Q：minimax api开放平台和 MiniMax 官网是同一个吗？ A：不是一套账号体系。开发者用 platform.minimaxi.com（内地）/ platform.minimax.io（海外）；minimaxi.com 是公司官网，海螺视频、星野等 C 端产品的账号与 API 额度互不相通。
Q：注册要钱吗？有免费体验额度吗？ A：注册免费，手机号 + 验证码即可，但需实名认证。是否赠送体验额度在官方公开文档中未见明确说明，部分第三方教程称"注册即送"，以控制台实际展示为准。
Q：怎么调用最省钱？ A：M3 当前五折执行价与 M2.7 持平，直接上 M3；重复前缀利用缓存读取（省约 80% 输入成本）；别开 priority/highspeed 加急档；单次输入控制在 512k tokens 以内，避开翻倍价区。
Q：API Key 和订阅 Key 有什么区别？ A：API Key 走按量计费、消耗充值余额；订阅 Key 走 Token Plan 包月额度。两者消耗不同资源、不可互换，SDK 里填哪个取决于你要用哪种计费。
Q：支持 OpenAI SDK 直接切换吗？ A：支持。OpenAI 兼容路径把 base_url 改成 https://api.minimaxi.com/v1 即可；官方同时提供 Anthropic 兼容路径（/anthropic），并推荐用它调用高阶模型特性，还支持 Responses API。
Q：语音合成怎么计费，1 万字符能合成多久？ A：speech-2.8-hd 为 3.5 元/万字符，turbo 为 2 元/万字符。注意 1 个汉字算 2 个字符；异步接口单次最多支持 100 万字符输入。
Q：视频 API 免费吗？ A：官方公布的是"免费速率档"而不是免费成片额度——免费档只限调用速度（Hailuo 免费 5 次/分钟，H3 免费 2 个并发任务），生成本身按秒计费。别把速率档当成白嫖通道。
Q：内地和海外账户能混用吗？ A：不能。API Key 分区域，内地 Key 配 api.minimaxi.com、Global Key 配 api.minimax.io，混用会报 401/1004。服务区域以你购买的平台为准。
Q：音乐 API 现在还能用吗？ A：2026 年 8 月 20 日起付费音乐接口不再向新用户开放，免费接口全部停服；历史付费用户可继续使用。新用户可体验 MiniMax Audio 或自行部署开源 Music 3 模型。
MiniMax 的模型清单、价格、折扣活动与接口政策可能随时调整（该平台 2026 年内已发生多次定价变更），请以 platform.minimaxi.com 官方文档与控制台实时展示为准。第三方数据已注明来源与核实日期，仅供参考。
AI 速览
