如何在 AIHubMix 上使用 Xiaomi MiMo v2.6 Pro：设置指南

更新（2026 年 10 月 23 日）： mimo-v2.5-pro 已于 2026 年 10 月 21 日停用，AIHubMix 不再接受对它的请求。请改用价格相同的 mimo-v2.6-pro。

简而言之： 将官方 openai Python SDK 指向 https://aihubmix.com/v1，使用模型 ID mimo-v2.6-pro，并通过 AIHubMix 密钥进行身份验证。该 API 兼容 OpenAI（可采用与 OpenAI 相同的格式调用），因此无需专用客户端。设置大约需要五分钟。

要点

• 兼容 OpenAI 的 API ——只需更改 base_url，其他内容不变
• 付费版 mimo-v2.6-pro · 免费版 xiaomi-mimo-v2.6-pro-free [1] [2]
• $0.48/M 输入 · $0.96/M 输出 [1]
• 免费层级 5 次请求/分钟 · 100 次/天 · 1M tokens/天 [2]
• 上下文 1.05M tokens · 最大输出 131K tokens [1]
• 要求：Python 3.9+、AIHubMix API 密钥

参考值

该选择 v2.6 Pro 还是 v2.5 Pro？

选择 v2.6 Pro。价格相同，而且支持更多种类的输入。

小米的发布说明称，V2.6“采用与 V2.5 系列相同的 API 定价”，并指出 V2.6-Pro 在 Artificial Analysis Intelligence Index 上得分 46，是撰写本文时开源模型中的最高分，高于 Kimi K3 和 Qwen3.8 Max，低于 Claude Fable 5.1 和 GPT-6 Astra [4]。发布说明中最明确的代际对比针对的是价格更低的模型：V2.6-Flash “全面超越了 MiMo-V2.5-Pro”[4]。

有两点需要注意。小米尚未发布 V2.6-Pro 与 V2.5-Pro 的直接基准测试对比表，因此上面的比较依据是规格和价格。另外，mimo-v2.5-pro 计划于 2026 年 10 月 21 日停用，指定 mimo-v2.6-pro 为迁移目标 [5]，因此任何基于 v2.5 新开发的内容都需要几乎立刻迁移。

为什么选择 AIHubMix

• 只需更改 base_url。 该网关采用 OpenAI Chat Completions 格式，因此官方 SDK 无需修改即可使用。同一个密钥还可用于 Anthropic 格式的 /v1/messages（测试版）和原生 Gemini 调用 [6]。
• 一个密钥即可接入多个供应商。 设置当天，GET /v1/models 返回了 416 个模型 ID，其中 21 个是 MiMo 变体 [3]。切换模型只需更改脚本中的一个字符串。
• 你可以先免费测试。 xiaomi-mimo-v2.6-pro-free 在每分钟 5 次请求、每天 100 次请求和每天 1M tokens 的限额内免费 [2]——足以在花费任何费用之前确认设置正常。
• 无需订阅。 采用按量付费，没有会员资格或月费 [6]；MiMo 付费版的费率与模型页面一致：输入 $0.48/M，输出 $0.96/M [1]。
• 调试更快。 如果调用失败，可将同一脚本指向其他供应商的模型。如果在那里调用成功，就说明密钥、URL 和请求格式都没问题，问题出在模型上——一次调用即可定位，无需花上一个下午。

如何设置

1. 创建项目

mkdir mimo-demo && cd mimo-demo
python3 -m venv .venv
.venv/bin/pip install "openai>=1.40" "python-dotenv>=1.0"

2. 保存密钥

printf 'AIHUBMIX_API_KEY=your_key_here\n' > .env
chmod 600 .env
printf '.env\n.venv/\n__pycache__/\n' > .gitignore

切勿将密钥硬编码在脚本中，也不要提交 .env。

3. 创建客户端

保存为 chat.py：

import os
import sys

from dotenv import load_dotenv
from openai import OpenAI

load_dotenv()

client = OpenAI(
    api_key=os.environ["AIHUBMIX_API_KEY"],
    base_url="https://aihubmix.com/v1",
)

prompt = sys.argv[1] if len(sys.argv) > 1 else "Introduce yourself in one sentence."

stream = client.chat.completions.create(
    model="mimo-v2.6-pro",
    messages=[{"role": "user", "content": prompt}],
    max_tokens=1024,
    stream=True,
)

for chunk in stream:
    if not chunk.choices:
        continue
    piece = chunk.choices[0].delta.content
    if piece:
        print(piece, end="", flush=True)
print()

将两个检查都放在循环内。有些数据块的 choices 数组为空，如果直接索引就会引发 IndexError；第一帧和最后一帧中的 delta.content 为 None，如果直接 print，就会输出字面文本 None。

4. 运行

.venv/bin/python chat.py "Introduce yourself in one sentence."

我是 MiMo，由小米 LLM Core Team 开发的大语言模型，可协助回答问题、撰写内容以及完成各种实用任务。

预计约六秒后会收到第一个 token，模型页面上列出的延迟为 6.4 秒 [1]。

5. 根据需要调整

如需非流式调用，移除 stream=True 并读取 response.choices[0].message.content。如需切换模型，请更改 model 参数。若要生成更长的输出，请增大 max_tokens——上面默认的 1024 远低于模型的上限 [1]。

检查清单

• [ ] 已创建虚拟环境；已安装 openai 和 python-dotenv
• [ ] .env 中包含真实密钥，权限已设为 chmod 600
• [ ] .env 已列入 .gitignore
• [ ] base_url 为 https://aihubmix.com/v1——必须包含 /v1
• [ ] 模型 ID 为 mimo-v2.6-pro（付费版）或 xiaomi-mimo-v2.6-pro-free（免费版）
• [ ] 流式循环会检查 chunk.choices 和 delta.content
• [ ] 测试调用成功返回文本

常见问题

这个 API 确实兼容 OpenAI 吗？ 是的——采用标准 Chat Completions 格式。任何兼容 OpenAI 的客户端都可以使用，只需将基础 URL 设为 https://aihubmix.com/v1，并将 AIHubMix 密钥作为 bearer token 传入。AIHubMix 文档指出，coding-xiaomi-mimo-v2.6-flash 仅支持 OpenAI 兼容格式 [3]。

应该使用哪个模型 ID？ 付费版使用 mimo-v2.6-pro，免费版使用 xiaomi-mimo-v2.6-pro-free。两个层级采用不同的命名规则——免费版带有 xiaomi- 前缀，付费版则没有，很容易弄错。

还有哪些其他变体可用？ mimo-v2.6-pro-ultraspeed、mimo-v2.6-flash、mimo-v2.5-pro，以及经过代码任务调优的 ID，例如 coding-xiaomi-mimo-v2.6-pro [3]。可通过 API 列出这些模型：

curl -s https://aihubmix.com/v1/models \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  | python -c "
import json,sys
for i in sorted(m['id'] for m in json.load(sys.stdin)['data']):
    if 'mimo' in i: print(i)
"

我遇到 429 错误——这是什么意思？ 这取决于错误消息，两种情况需要采取相反的处理方式。“rate limited by provider”表示触发了每分钟速率限制：等待后重试。“reached the limit of the free model quota”表示账户的免费额度已用完，而且额度由所有免费模型共用——重试无济于事，请改用 mimo-v2.6-pro。

我收到 400 错误“cannot be served at the moment”。 请先通过 API 确认模型 ID：

curl -s https://aihubmix.com/v1/models \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  | python -c "import json,sys; print('mimo-v2.6-pro' in [m['id'] for m in json.load(sys.stdin)['data']])"

如果输出 True，请用 curl 重复聊天调用，并查找 "code": "no_available_channel"。这表示模型虽已列出，但当时没有可用的上游容量——这是供应商端的问题，无法通过本地更改解决。请稍后重试，或向 AIHubMix 支持团队提供响应中的请求 ID。

如何判断问题出在我这边还是供应商那边？ 使用相同的密钥和脚本调用其他供应商的模型，例如 gpt-4o-mini。如果调用成功，说明密钥、基础 URL 和请求格式都正确，问题出在该特定模型上。如果也失败了，请检查密钥和账单。

为什么输出到句子中途就截断了？ 你触及的是 max_tokens 限制，而不是模型限制。请调高它。

如何检查账户状态？

curl -s https://aihubmix.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

查看 has_payment_method 和限额字段。

后续步骤

上面的脚本是一个可用的基础版本。MiMo v2.6 Pro 列出的功能包括工具调用、结构化输出、视觉和音频输入，以及提示词缓存 [1]——这些功能都通过同一个兼容 OpenAI 的接口提供，因此扩展客户端主要只需添加标准参数。先使用免费层级确认设置正常，然后将模型 ID 切换为 mimo-v2.6-pro，即可日常使用。

来源

• [1] AIHubMix 模型页面，mimo-v2.6-pro：https://aihubmix.com/model/mimo-v2.6-pro （访问日期：2026 年 9 月 28 日）
• [2] AIHubMix 模型页面，xiaomi-mimo-v2.6-pro-free：https://aihubmix.com/model/xiaomi-mimo-v2.6-pro-free （访问日期：2026 年 9 月 28 日）
• [3] 来自 GET /v1/models 端点和 AIHubMix 模型页面的变体 ID 与格式说明（访问日期：2026 年 9 月 28 日）
• [4] Xiaomi MiMo 发布说明，V2.6 系列：https://mimo.mi.com/docs/en-US/news/latest/v2-6 （访问日期：2026 年 9 月 28 日）
• [5] AIHubMix 模型页面，mimo-v2.5-pro：https://aihubmix.com/model/mimo-v2.5-pro （访问日期：2026 年 9 月 28 日）
• [6] AIHubMix 产品文档：https://docs.aihubmix.com/en （访问日期：2026 年 9 月 28 日）