如何获取MiMo API Key?MiMo 是小米公司研发的大模型系列,它的 API Key 不在品牌官网申请,而在开放平台控制台里创建——官方文档的原文是「登录 Xiaomi MiMo API 开放平台后,在控制台-API Keys 页面申请 API Key」。需要先分清的是,这里的 Key 有两类:按量付费用 sk- 开头的密钥,Token Plan 订阅用 tp- 开头的密钥,官方明确写着「两者相互独立,不可混用」,混用会直接报 401 认证失败。
MiMo API Key的官方入口在哪
小米为 MiMo 同时开了多个域名,分工不同,先认准入口再动手,可以少走弯路。实测这四个域名的解析结果都指向同一台负载均衡(mimo-pri-prod.alb.xiaomi.com),即背后是同一套后端,只是对外暴露的入口各有用途。
| | | |
|---|
| | 创建与管理 API Key、充值、订阅 Token Plan、查看用量 | |
| | | |
| | | |
| | | |
这里有一个容易被绕晕的地方:控制台的文档路径(platform.xiaomimimo.com/#/docs/...)打开后会自动跳到文档站 mimo.mi.com/docs/...,两个地址是同一份内容。另外,直接访问控制台的 API Keys 页(platform.xiaomimimo.com/console/api-keys)会立刻被重定向到 account.xiaomi.com 的登录页,地址里带着 sid=api-platform 参数——这就是「API Key 必须用小米账号登录后才能创建」的现场证据,未登录状态下看不到任何密钥管理界面。
还要提醒一点:官方帮助中心明确说明「小米目前未推出官方的 MiMo 独立 APP,非官方渠道的相关下载软件存在安全风险,请勿下载」。想用网页版直接体验走 MiMo Studio,想接 API 走开放平台,两条路都不需要装任何 App。
MiMo API Key怎么获取
官方文档把「调用前准备」和「获取凭证」写成两节,实际操作可以合并成五步。注意第 2 步是很多人会漏掉的前置条件:不完成实名认证,无法充值,也无法购买套餐。
- 注册或登录小米账号:官方原文是「目前平台仅提供个人账号登录方式,需使用小米账号登录」。中国大陆用户可用手机号注册,或用微信、微博、QQ、支付宝、Apple ID 三方授权注册;海外用户用邮箱注册,或用 Google、Facebook 三方授权注册。手机号和邮箱注册也可在 id.mi.com 提前完成。
- 完成实名认证:官方付费 FAQ 原文是「国内用户充需要完成个人或企业实名认证后才能充值或购买套餐。两种认证类型都可以购买」。同一个账号只支持认证为一种类型,个人账号可通过企业认证变更为企业账号,企业账号不能变更为个人账号。
- 进入控制台创建 Key:登录后进入「控制台 - API Keys」页面申请。按量付费与 Token Plan 的凭证取自不同位置——前者在 API Keys 页创建,后者在购买套餐成功后于 Token Plan 页面查看专属 API Key。
- 立刻保存密钥:官方原文加了一句必须照做的提示——「API Key 仅在创建时可见可复制,请妥善保存。」换句话说,关掉页面之后就无法再看到完整密钥,只能重新创建。官方建议把 Key 配置进环境变量,不要硬编码在代码里。
- 按用途配置 Base URL 与请求头:请求头支持两种写法,任选其一——api-key: $MIMO_API_KEY 或 Authorization: Bearer $MIMO_API_KEY。但 Base URL 必须与密钥类型对应,用错了会报错,具体对应关系见下一节。
如果只是想先跑通一次请求,官方文档给出的是 OpenAI 兼容写法:把 base_url 设为 https://api.xiaomimimo.com/v1、模型填 mimo-v2.5-pro,再带上刚保存的 Key 即可。官方还额外建议在系统提示词里写明当前日期与知识截止日期(官方示例写的是知识截止 2024 年 12 月),这一点在调用长任务时对结果稳定性有帮助。
MiMo API Key的两种密钥有什么区别
这是「获取 MiMo API Key」这道题里最容易被忽略、也最容易踩坑的一点:MiMo 的密钥不是一把,而是两把,且格式、用途、Base URL 全都不同,官方原文明确写着「两者相互独立,不可混用」。
| | | | |
|---|
| | https://api.xiaomimimo.com/v1(OpenAI 兼容)或 /anthropic(Anthropic 兼容) | | |
| | https://token-plan-cn.xiaomimimo.com/v1(OpenAI 兼容)或 /anthropic(Anthropic 兼容) | | 仅在套餐有效期内可用;可在 Token Plan 页面重置 |
顺带记下一处官方留白:按量付费密钥丢失后怎么重置,官方文档里没有给出对应说明,只说明了 Token Plan 可以重置。遇到这种情况,建议直接通过官方客服邮箱 support-mimo@xiaomi.com 询问,不要照搬第三方教程里的说法。
混用后果有多严重,官方错误码表自己给了答案:401「认证失败」的成因一栏,白纸黑字写着「混用了 Token Plan 和按量付费 API 的 API Key」。也就是说这不是理论风险,而是官方专门列出来的一类高频报错。
注意区域区分:国内与海外的 Key 不互通。官方账号 FAQ 原文写着「根据账号所在地区返回不同的 Base URL + Key,不互通」,并明确回答「国内和海外的用量不可以聚合计算,用量是分开计算的」。所以同一份代码搬到不同地区注册的账号上,Base URL 与 Key 都需要换。此外,官方桌面客户端的邀测公告里注明「暂不在欧盟、英国及韩国提供服务」;对应地,错误码表把 403「拒绝访问」的成因写成「服务暂不支持当前地区,或 API Key 被风控」,两个说法可以互相印证。
MiMo API Key能调用哪些模型
截至本文核对时间,官方模型清单页在售的 MiMo 模型共 6 款,分成文本生成、语音识别、语音合成三类,上下文长度与并发配额并不一致,选型时值得逐列比对。这里的 RPM 指每分钟最多发起的请求数,TPM 指每分钟最多交互的 Token 数,两者都按「同一模型下该账号所有 API Key 合计」计算。
| | | |
|---|
| 文本生成、深度思考、函数调用、结构化输出、联网搜索 | | |
| 文本生成、全模态理解、深度思考、函数调用、结构化输出、联网搜索 | | |
| | | |
| | | |
| | | |
mimo-v2.5-tts-voicedesign | | | |
选型上,官方给了「快速选型指南」这一节:复杂推理、深度分析、长文档处理用 mimo-v2.5-pro;图片、音频、视频内容理解用 mimo-v2.5;语音转文字用 mimo-v2.5-asr;标准预置音色的文字转语音用 mimo-v2.5-tts;上传音频样本做声音克隆用 mimo-v2.5-tts-voiceclone;自定义音色设计用 mimo-v2.5-tts-voicedesign。按官方发布说明,mimo-v2.5-pro 的规格是 1T 总参数、42B 激活参数、1M 超长上下文,官方对其智能体场景的表述是「表现媲美 Claude Opus4.6」——这属于厂商自评口径,不是第三方实测数据。 接口格式方面,官方同时兼容两种主流协议:OpenAI 协议走 /v1/chat/completions,角色包含 developer、system、user、assistant;Anthropic 协议走 /anthropic/v1/messages,使用单独的 system 参数。此外官方还上线了兼容 OpenAI Responses API 的接入方式,并提供 GET /v1/models 用于列出可用模型。需要注意两处能力边界:联网搜索目前只有 mimo-v2.5-pro 与 mimo-v2.5 支持,且官方原文写「暂不支持本地文件上传」。
MiMo API Key的计费价格是多少
按量付费与 Token Plan 是两套完全独立的计价体系,得分开看。按量计费使用开放平台普通 API Key,按实际 Token 用量消耗账户余额,官方明确写着「与 Token Plan 套餐额度不互通」。计费单位为元/百万 tokens(国内)或美元/百万 tokens(海外),请求前缀命中 Prompt Cache 时按命中缓存价计费。
| | | |
|---|
| | | |
| | | |
| ¥0.5 / 小时(按输入音频时长计费,统计精确到秒、折算成小时) |
| |
把国内价格与官方海外价格页并排看,能发现两组数字是各自独立标价、不是简单汇率换算:mimo-v2.5-pro 海外为 $0.0036/$0.435/$0.87,mimo-v2.5 为 $0.0028/$0.14/$0.28,mimo-v2.5-asr 为 $0.074/小时。这也再次印证了「国内与海外账号不互通」那条规则。另外官方把缓存写入标注为「限时免费」,联网搜索则按调用次数单独计费、不含在 Token 价格里:国内联网服务 ¥16/1000 次,海外 $5/1000 次,都包含网页搜索与网页解析。
Token Plan 是面向 AI 编程场景的订阅方案,官方口径为「四级梯度套餐」,月付原价与年付原价如下表。这里要特别说明一件事:官方文档站与官方 Token Plan 落地页对同一个档位给出的「月价读数」并不相同——文档站列的是原价,落地页在切换订阅周期后展示的是折后读数。
落地页实测(2026 年 9 月 15 日)显示的是首购 88 折后的价格:Lite ¥34.32/月、Standard ¥87.12/月、Pro ¥289.52/月、Max ¥579.92/月,对应的「立减」额分别是 ¥4.68、¥11.88、¥39.48、¥79.08。切换成连续包年视图后,页面上出现的仍然是同一组月价读数,但含义变了——那是年付总额摊到每月的金额(¥6959.04 ÷ 12 = ¥579.92),旁边标注「按年计费立减 948.96 元」(¥659 × 12 − ¥6959.04 = ¥948.96)。两套读数的数值之所以完全一致,是因为首购优惠与连续包年优惠都是 88 折这一个系数,算一遍就能确认,不必怀疑页面写错。年度套餐的 Credits 总额度分别是 492 亿、1320 亿、4560 亿、9840 亿。
官方还写明三条折扣与消耗规则:首购优惠每位账号仅享受 1 次;连续包年相比连续包月享 88 折,首购优惠不参与包年;非高峰期(北京时间 0:00 至 8:00)享 0.8 倍消耗系数。Credits 消耗按模型与 Token 类型分档:mimo-v2.5-pro 的缓存命中 / 未命中 / 输出分别按每 Token 2.5 / 300 / 600 Credits 扣除,mimo-v2.5 为 2 / 100 / 200,mimo-v2.5-asr 为每输入音频小时 30M Credits,TTS 系列限时免费、不消耗套餐 Credit。官方特别强调「套餐中的可用模型按不同比例并行消耗,不是独立消耗」。
MiMo API Key的准入门槛有几道
把官方分散在账号 FAQ、付费 FAQ 与首次调用文档里的限制合起来看,「拿到一把能用的 Key」实际要过 3 道门槛,且它们是递进关系——前一道不过,后一道无从谈起。
| | |
|---|
| 「目前平台仅提供个人账号登录方式,需使用小米账号登录」 | 打开控制台被跳到 account.xiaomi.com 登录页,看不到任何密钥管理界面 |
| 「国内用户充需要完成个人或企业实名认证后才能充值或购买套餐」 | 可以浏览文档,但无法充值、无法购买 Token Plan |
| | |
这里有几条容易被误解的细节,逐条说清。其一,实名认证分个人与企业两种,「企业账号的支付流程和个人账号完全一致,企业账号也支持微信/支付宝/小米支付」,企业并不需要走另一套通道;但同一账号只能认证为一种类型。其二,国内支持微信、支付宝、小米支付,海外通过 waffo 收银台以美元结算。其三,Token Plan 套餐不支持用账户余额或赠金抵扣,必须单独购买,且订阅订单不计入累计充值——这一点如果不知道,很容易以为账户里有余额就能直接开套餐。
关于退款,两套体系规则相反,务必分清:按量计费的账户余额支持全额退款,通过「充值明细」右上角的申请退款按钮发起,审核通过后原路退回、一般 3 至 5 个工作日到账,但已消费金额、已开票金额及平台赠送金额不能退;而 Token Plan 官方原文写明「套餐一经支付,无法退款」,落地页 FAQ 也复述为「支持自动续费,但是不支持退款」。发票方面,开票主体是北京小米移动软件有限公司,个人抬头只能开数电普通发票,企业抬头可开数电普通发票或数电专用发票,一般在收到申请后 48 小时内开具。
如果想先低成本试用,官方目前提供的是赠金而非固定免费额度。按官方活动说明,赠金可通过「邀请有礼」和新客注册两种途径获得,可用于抵扣按量计费的 API 调用费用。邀请机制的关键数字是:注册 3 天内的新用户绑定邀请码后双方各得 ¥10 体验金;好友完成 Token Plan 套餐首单实付,邀请人额外得到实付金额的 10% 赠金。但赠金有效期只有 40 天,从到账当天起算,过期自动失效,且不可提现、不可转让、不找零、不能用于购买 Token Plan 套餐。官方还设了上限:注册激励名额 30 个、付费赠金 30 笔,超过后不再发放。
MiMo API Key的常见报错有哪些
官方文档专门有一页「错误码」,收录 9 个常见状态码与处置办法,直接照抄官方表格比四处搜原因可靠。归一下类会更清楚:与凭证和权限相关的有 401、403;与账户金额相关的有 402;与请求本身相关的有 400、404、421;与流量和服务器相关的有 429、500、503。
| | |
|---|
| | 检查 JSON 格式、必需参数、参数取值范围、消息格式与模型名;多轮思考模式需完整回传 reasoning_content |
| 缺少或无效的 API Key,或 Authorization 请求头格式错误;混用了 Token Plan 和按量付费 API 的 API Key | 检查 API Key 与请求头格式;使用 Token Plan 时确认用的是专属 Base URL 和专属 API Key |
| | |
| | |
| | |
| | |
| 请求过于频繁,或者 Token Plan 的额度耗尽 | 实现指数退避与重试逻辑,或降低请求频率;升级套餐或切换为按量付费 API |
| | |
| | |
值得单独拎出来的是 429,它同时对应两种完全不同的成因:请求频率过高,以及 Token Plan 额度耗尽。这两种情况的处置方向相反——前者要降频重试,后者只能升级套餐或改用按量付费;而且官方写明额度耗尽后「系统将停止服务,不会继续消耗您的赠金或账户余额」,所以「账户里还有赠金」并不能让它继续跑。反过来看,如果调用突然全部失败而账单没动,先怀疑是套餐额度用完了,而不是账号被封。
另外两条来自 FAQ 的排错经验也值得记下:开启联网搜索后模型却没有联网,官方给了三个原因——开关切换存在 5 分钟缓存、模型判断当前问题无需实时信息(可设 forced_search: true 强制联网)、以及该模型本身不支持联网(当前只有 mimo-v2.5-pro 与 mimo-v2.5 支持)。而在思考模式下做多轮工具调用时,可能出现 tool_calls 混进 reasoning_content 字段的情况,官方解释这是「开启 thinking 导致的不稳定,输出不完整」,建议调用工具时关闭 thinking。
MiMo API Key的安全与合规提示
- 密钥只显示一次:官方原文「API Key 仅在创建时可见可复制,请妥善保存」。创建完成后请立即存入环境变量或密钥管理工具,不要留在聊天记录、笔记或截图里。
- 不要写进前端代码或代码仓库:官方建议把 API Key 配置到环境变量。浏览器端与移动端代码对使用者完全可见,一旦放进去等同于公开密钥;提交进 Git 仓库同理。
- Token Plan 密钥超期即失效:官方写明「Token Plan 的 API Key 仅在您所订阅的 Token Plan 套餐有效期内可用」,套餐到期后这把 Key 也随之失效,不要把它当成长期凭证布置到生产环境。
- 只从官方渠道获取:官方帮助中心明确声明「小米目前未推出官方的 MiMo 独立 APP,非官方渠道的相关下载软件存在安全风险,请勿下载」。同理,任何声称「付费代开 Key」「内部通道」「低价转卖额度」的渠道都应视为风险来源。
- 账号注销会连带失效:官方 FAQ 写明「小米账号注销后,平台数据将一并清空,且 API Key 会同步失效」,操作前务必评估。若账号被提示「存在异常使用行为」,官方说明是自动保护机制触发,可通过提供用户 ID 申请人工复核解封。
- 合规信息可核:官方页面公示的算法备案为「小米大语言模型算法,网信算备110108916280901240011号」,网站备案为「京ICP备17028681号-55」,另有服务备案号 Beijing-XiaomiMiMo-202601050182。若对来源存疑,可用这几项编号与官方公示页面相互核对。
几处流传说法已经过期或有误,逐条更正。其一,网上仍有「MiMo API 目前处于限时免费阶段,不需要充值,也暂时不支持充值」的说法,这来自平台公测期的开发者社区帖;当前官方价格页已列出完整的按量计费单价与 Token Plan 四档定价,官方付费 FAQ 也写明了退款、发票与欠费停服流程,说明计费系统已经上线,公测免费期的说法不再适用。其二,部分第三方站点为 MiMo 建了「产品介绍页」并给出 App 下载入口,而官方帮助中心明确表示小米未推出官方 MiMo 独立 APP,此类下载渠道存在安全风险。其三,免费额度的具体数值不要在第三方站点上找:官方公开页面只说明了「赠金可用于抵扣按量计费」这一机制与 40 天有效期,并未公布新账号固定赠送多少金额;能够确认的具体金额只有邀请活动里的 ¥10 体验金,且适用范围限注册地区为中国大陆的账号。
MiMo API Key常见问题
Q:MiMo API Key 是免费的吗?
A:Key 本身免费创建,但调用按规则计费——按量付费按 Token 用量扣余额,Token Plan 按套餐限量。官方公开的免费部分是邀请活动赠金(¥10 体验金,有效期 40 天)与限时免费的 TTS 系列模型。
Q:为什么我的 Key 创建了却调用不通?
A:先按官方错误码表分流。报 402 是余额不足;报 401 时优先怀疑混用了密钥——用 tp- 开头的密钥却填了 api.xiaomimimo.com 的 Base URL,或反过来,都会导致认证失败。
Q:Key 只显示一次,没存下来怎么办?
A:Token Plan 的密钥官方写明「可以在 Token Plan 页面进行重置操作」。按量付费密钥的重置方式官方文档未给出说明,建议通过 support-mimo@xiaomi.com 咨询官方,不建议按第三方教程操作。
Q:一个 Key 能用在多个编程工具里吗?
A:可以。官方原文是「可以在所有支持的工具中使用同一套餐,但额度是共享的,所有工具的使用会消耗同一套餐额度」。Token Plan 支持 Claude Code、OpenClaw、OpenCode、Kilo Code、Cline、Hermes Agent、CodeBuddy Code、Chatbox AI、Cherry Studio、Qwen Code、MiMo Code、Codex 等工具。 Q:需要企业资质才能申请吗?
A:不需要。官方写明平台仅提供个人账号登录方式、需用小米账号登录,实名认证个人与企业两种都可以购买套餐,且「企业账号的支付流程和个人账号完全一致」。个人账号后续可变更认证为企业账号,反向不可变更。
Q:调用有并发上限吗?
A:有。官方写明平台对每个账号设有模型并发上限,超限或服务器负载高时会出现响应延迟或 429 报错。已公布的具体配额为文本与 TTS 模型 RPM 100、TPM 10M,ASR 模型 RPM 100、TPM 10K,均按该账号所有 API Key 合计计算。
Q:Token Plan 没到期但额度用完了还能用吗?
A:不能。官方原文写「套餐在到期或全部 Credits 额度用完任一条件满足时,即停止服务」,且不会继续消耗赠金或账户余额。官方给的解法是补差价升级套餐,或切换到按量付费 API。
Q:买了 Token Plan 还能退吗?
A:不能。官方两处口径一致——「套餐一经支付,无法退款」。这与按量计费余额可全额退款形成对比,购买前建议先算清用量。
Q:官方推荐先用哪个模型跑通?
A:官方快速接入示例用的是 mimo-v2.5-pro 配 OpenAI 兼容协议,并按官方建议在系统提示词里写明当前日期与知识截止日期。若只是验证链路通不通,这组配置是最短路径。