小米MiMo开放平台：注册免费送体验额度，全模态模型可调用

平台接口与 OpenAI 兼容，只要把 base_url、密钥和模型名换成 MiMo 的，就能复用现有的 SDK 或工具（例如 Claude Code、Cursor 里的自定义 API 配置）。

base_url 与模型名从哪获取

OpenAI 兼容接口的 base_url 一般形如 https://platform.xiaomimimo.com/v1，具体以控制台「接入文档 / API 文档」中给出的地址为准，注意结尾只需要到 /v1，不要自己再拼上 /chat/completions。模型 ID 请在控制台的模型列表或订阅管理页查看，资料中提到的 MiMo-V2.6 系列与 TTS 模型都能在那里找到；下文示例中的 mimo-v2.6 只是写法示范，请替换成列表里显示的那一串。

第一步：把密钥放进环境变量

不要把密钥硬编码进代码，先写入环境变量：

export MIMO_API_KEY="你的控制台密钥"

第二步：用 curl 发一次对话补全

下面这条命令可以直接用于连通性测试，返回 JSON 里有 choices 字段就说明调用成功：

curl https://platform.xiaomimimo.com/v1/chat/completions \
  -H "Authorization: Bearer $MIMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mimo-v2.6",
    "messages": [
      {"role": "system", "content": "你是一个简洁的中文助手"},
      {"role": "user", "content": "用一句话介绍你自己"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

第三步：用 Python SDK 调用

如果已经安装 openai 官方 SDK，只改 base_url 和密钥即可：

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["MIMO_API_KEY"],
    base_url="https://platform.xiaomimimo.com/v1",
)

resp = client.chat.completions.create(
    model="mimo-v2.6",
    messages=[
        {"role": "system", "content": "你是一个简洁的中文助手"},
        {"role": "user", "content": "用一句话介绍你自己"},
    ],
    temperature=0.7,
    max_tokens=512,
)

print(resp.choices[0].message.content)

关键参数说明

• model：必填，填控制台模型列表中的模型 ID，写错会直接报参数错误。
• messages：必填，数组，每个元素形如 {"role": "user", "content": "..."}，role 取 system、user、assistant。
• temperature：采样随机性，取值 0 到 1；问答、抽取类任务建议 0.2 到 0.7，创作类可以调高。
• max_tokens：单次回复的最大长度，设得太小会出现回答被截断，设得过大在长上下文时会更容易超限。
• stream：设为 true 时以流式返回，适合接聊天界面，此时客户端要按 SSE 逐块解析。

额度耗尽与限流的典型表现与排查顺序

先看 HTTP 状态码，再改代码：401 多为密钥错误或没带 Authorization 头；403 常见于账号未实名或该模型未开通；404 一般是 base_url 写错或多写了路径；400 是请求体问题，重点检查模型名与 messages 结构；429 要区分是速率限制还是额度用尽，先到控制台「订阅管理」看剩余额度与到期时间，再降低并发或拉长请求间隔。

如果之前能正常调用、现在全部报错，按「密钥是否被删除或轮换 → 免费额度是否已到期 → 实名认证是否失效 → 该模型是否下线或被改名」的顺序排查，基本能定位到原因。确认额度确实用完后，再决定是否充值，不要因为限流就盲目加钱。