小米 MiMo 大模型 API 的官方入口是 platform.xiaomimimo.com,接口地址为 https://api.xiaomimimo.com/v1,兼容 OpenAI 与 Anthropic 协议。当前开放 V2.5 系列模型,采用预充值按量计费(TTS 系列限时免费)。本文整理了入口、价格、错误码等实用指南。 MiMo API 官方入口与控制台
- 接口文档:mimo.mi.com/docs/en-US/(含 OpenAI / Anthropic 协议、音频、错误码说明);
- API Keys 管理:platform.xiaomimimo.com/console/api-keys —— 创建与删除密钥;
- 用量与余额:platform.xiaomimimo.com/console/balance —— 实时查询 Token 消耗与请求数;
- Token Plan 订阅:platform.xiaomimimo.com/token-plan —— 固定订阅、套餐额度、夜间折扣。
注意区分:平台提供「按量付费」与「Token Plan」两套接入方式,两者的 Base URL 与 API Key 互不相同、互不通用;国内与海外账号也返回不同的 Base URL 与 Key,用量分开计算。
获取 API Key 的五个步骤
- 进入控制台「API Keys」创建密钥:按量付费 Key 格式为 sk-xxxxx,Token Plan Key 格式为 tp-xxxxx;
- API Key 仅在创建时显示一次,请立即复制并保存到环境变量,切勿写入代码或前端;一旦泄露需删除重建;
- 国内用户充值或购买套餐前,需先完成个人/企业实名认证,否则无法充值调用;
- 账户余额为零会直接报 402,请先在控制台充值后再发起请求。
MiMo-V2.5 模型清单与价格一览
截至核查时间(2026-09-11),API 开放 V2.5 系列模型,旧版 V2 系列已于 2026 年 6 月 30 日正式弃用,需尽快迁移。各模型上下文均为 1M tokens:
| | | |
|---|
| | | |
| | | |
| | | |
mimo-v2.5-tts / -tts-voiceclone / -tts-voicedesign | | | |
国内定价(元 / 百万 tokens,更新于 2026-08-06):
浮动计费说明:缓存命中价约为未命中的 1/50,重复前缀强烈建议开启 Prompt Cache;缓存写入限时免费;联网搜索插件独立计费(国内 ¥16 / 千次、海外 $5 / 千次),不计入 Token 价格。海外以美元计价:mimo-v2.5-pro 为 $0.0036 / $0.435 / $0.87,mimo-v2.5 为 $0.0028 / $0.14 / $0.28(输入命中 / 输入未命中 / 输出,每百万 tokens)。
计费规则与免费额度说明
平台采用预充值按量扣费模式(Pay-as-you-go),用普通 API Key 消耗账户余额,余额实时可查;另有 Token Plan 固定订阅方案,使用专属 tp- Key 与套餐额度,二者不互通。
关于新用户是否仍赠送免费额度、金额与有效期,官方未固化具体数字,以控制台实时显示为准(历史上曾有多轮限免与试用活动)。
国内用户充值或购套餐前需完成实名认证;海外通过 Waffo 控制台以美元结算,暂不支持开票。
常见报错与错误码速查
| | |
|---|
| 请求格式无效(JSON 错误、缺参、参数越界、模型不存在、多模态文件不合规) | 检查 JSON 与必填参数、参数取值范围、消息格式及文件可访问性 |
| 鉴权失败:API Key 缺失/无效、请求头格式错误,或混用了 Token Plan 与按量 Key | 核对 Key 与请求头格式;用 Token Plan 时必须换专属 Base URL 与 tp- Key |
| | |
| | |
| | |
| | |
| 请求过于频繁,或 Token Plan 套餐配额已耗尽 | 实现指数退避重试、降低频率;或升级 Token Plan、切换按量 API |
| | |
| | |
各模型有独立的 RPM / TPM 与并发配额,触发即返回 429;具体数值以官方「Pricing and Rate Limits」页与控制台为准。思考(thinking)模式下 temperature 与 top_p 会被模型强制设为 1.0 / 0.95。
小米MiMo大模型API常见问题
Q:小米 MiMo API 免费吗?
A:按量计费需先充值;TTS 系列模型限时免费;历史上曾有多轮限免与试用活动,当前新用户是否赠送额度以控制台实时显示为准。
Q:API 接口地址(Base URL)是什么?
A:按量付费为 https://api.xiaomimimo.com/v1(OpenAI 协议)或 /anthropic(Anthropic 协议);Token Plan 使用专属 https://token-plan-cn.xiaomimimo.com/v1,两套不互通。
Q:怎么获取 API Key?
A:用小米账号登录 platform.xiaomimimo.com 控制台,进入「API Keys」创建,格式为 sk-xxxxx,密钥仅显示一次需立即保存。
Q:目前支持哪些模型?
A:开放 V2.5 系列(mimo-v2.5-pro、mimo-v2.5、asr、tts);旧版 V2 系列已于 2026-06-30 弃用,需迁移至 V2.5。
Q:和 OpenAI 接口兼容吗?
A:兼容 OpenAI Chat Completions 与 Anthropic Messages 协议,现有项目只需修改 base_url 与 model 即可迁移,支持流式、函数调用与深度思考。
Q:调用报错 401 / 402 / 429 怎么解决?
A:401 检查 Key 与请求头、勿混用两套 Key;402 先充值;429 降频重试或升级 Token Plan 套餐。
Q:国内和海外账号通用吗?
A:不通用。平台按账号地区返回不同的 Base URL 与 Key,用量分开计算,海外版本目前不支持开票。
Q:调用需要实名认证吗?
A:国内用户充值或购买套餐前需完成个人/企业实名认证;海外用户用邮箱或第三方账号注册即可。
Q:API Key 和数据安全如何保障?
A:登录依托小米账号体系,Key 泄露需删除重建;注销小米账号后 API Key 同步失效;建议将 Key 存入环境变量而非代码。
以上内容仅供参考,模型、价格、配额与免费政策可能随官方更新而变动,请以小米 MiMo 开放平台(platform.xiaomimimo.com)与官方文档最新公布为准。