小米 MiMo API 接入指南
本页是小米 MiMo 大模型 API 的中文接入文档。MiMo API 完全兼容 OpenAI 接口规范,开发者可以直接复用 OpenAI SDK、curl、LangChain、LlamaIndex 等工具,无需重新学习。下方示例代码、模型 ID、端点 URL 均保持英文原样以便直接复制使用。
💰 定价更新(2026-05-27): MiMo API 永久降价:MiMo-V2.5-Pro 输入 $1 / 百万 token,输出 $3 / 百万 token,降幅最高 99%。Token Plan 订阅积分同步增加 5-8 倍,无需额外付费。
快速开始
MiMo API 完全兼容 OpenAI 协议。可以用一行 curl 命令直接调用,也可以使用 OpenAI 官方 Python SDK:
curl https://api.xiaomimimo.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MIMO_API_KEY" \
-d '{
"model": "mimo-v2.5-pro",
"messages": [{"role": "user", "content": "Hello, what can you do?"}],
"temperature": 0.7,
"max_tokens": 1024
}'
1. 鉴权认证(Authentication)
调用 MiMo API 需要先在 Xiaomi MiMo 开放平台 获取 API Key:
- 前往 platform.xiaomimimo.com 注册账号
- 进入「API Keys」页面 → 点击「Create New Key」创建新密钥
- 在请求头中使用
Authorization: Bearer <你的密钥> - 新注册账号自动获得 2 美元免费试用额度(无需信用卡)
2. 可用模型(Available Models)
| Model ID | Description | Context | Pricing (Input/Output) |
|---|---|---|---|
mimo-v2.5-pro | Flagship agent model, 1T+ params | 1M tokens | $1.00 / $3.00 |
mimo-v2.5-omni | Full-modal (image+video+audio+text) | 128k tokens | $1.50 / $4.00 |
mimo-v2.5-tts | Speech synthesis | — | $2.00 / hour audio |
mimo-v2-flash | MoE flagship, 309B/15B active | 56k tokens | $0.50 / $1.50 |
mimo-7b-instruct | Lightweight reasoning, on-device ready | 32k tokens | $0.15 / $0.45 |
3. Python 集成(Integration)
使用 OpenAI 官方 Python SDK(v1.0+),只需替换 base_url 和 API Key:
from openai import OpenAI
client = OpenAI(
api_key="your-mimo-api-key",
base_url="https://api.xiaomimimo.com/v1"
)
response = client.chat.completions.create(
model="mimo-v2.5-pro",
messages=[
{"role": "system", "content": "You are MiMo, a helpful AI assistant."},
{"role": "user", "content": "Explain MoE architecture in 3 sentences."}
],
temperature=0.7,
max_tokens=512
)
print(response.choices[0].message.content)
4. Token Plan 订阅
MiMo Token Plan 是面向 AI 编程场景设计的订阅包,提供高性价比的旗舰模型积分套餐,可用于 MiMo Code、Cursor、Cline、Zed 等主流编程工具:
- 编程优化:专门为 MiMo Code / Cursor / Cline / Zed 用户调优
- 自动续费:支持订阅自动续费(2026 年 4 月起开放)
- 5-8 倍积分:近期升级增加积分配额,价格不变
- 全球可用:2026 年 5 月起全球开放
5. 从 OpenAI 迁移
从 OpenAI 迁移到 MiMo API 几乎不需要改代码:
| OpenAI | MiMo |
|---|---|
api.openai.com | api.xiaomimimo.com |
gpt-4o | mimo-v2.5-pro |
gpt-4o-mini | mimo-v2-flash |
| OpenAI SDK | Same SDK, different base_url |
只需替换 base_url 和模型名,API 完全兼容!
了解更多 MiMo 的编程能力,参见 MiMo Code 编程智能体解读 → 和 MiMo vs DeepSeek 性能对比 →
6. 速率限制与最佳实践
- 速率限制:根据订阅档位不同;Token Plan 订阅用户享有更高限额
- 重试策略:对 429/503 响应使用指数退避(exponential backoff)
- 流式输出:设置
stream: true即可获得逐 token 实时响应 - 工具调用:MiMo-V2.5-Pro 原生支持 function calling,可用于 Agent 工作流
7. API 端点(Endpoints)
| Endpoint | Description |
|---|---|
POST /v1/chat/completions | Chat completions (primary) |
GET /v1/models | List available models |
POST /v1/embeddings | Text embeddings |
🖥️ 推荐 GPU 算力平台
以下平台可用于部署 MiMo 模型推理与微调,新用户注册均有免费额度。