簡而言之: 將官方 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 令牌/天 [2]
- 上下文 1.05M 令牌 · 最大輸出 131K 令牌 [1]
- 要求:Python 3.9+,一個 AIHubMix API 密鑰
參考值
| 基本 URL | https://aihubmix.com/v1 |
| 協議 | OpenAI 聊天完成 |
| 收費模型 ID | mimo-v2.6-pro |
| 免費模型 ID | xiaomi-mimo-v2.6-pro-free |
| 定價(收費) | $0.48/M 輸入 · $0.96/M 輸出 · $0.0038/M 快取讀取 [1] |
| 免費層限制 | 5 請求/分鐘 · 100 請求/天 · 1M 令牌/天 [2] |
| 上下文窗口 | 1.05M 令牌 [1] |
| 最大輸出 | 131K 令牌 [1] |
| 輸入模式 | 文本、視覺、音頻、視頻 — 僅文本輸出 [1] |
| 列出的功能 | 流式傳輸、工具調用、結構化輸出、提示快取 [1] |
應該使用 v2.6 Pro 還是 v2.5 Pro?
使用 v2.6 Pro。它的價格相同,並且接受更多類型的輸入。
mimo-v2.5-pro | mimo-v2.6-pro | |
|---|---|---|
| 輸入 | 僅文本 [5] | 文本、視覺、音頻、視頻 [1] |
| 價格輸入/輸出 | $0.48/M · $0.96/M [5] | $0.48/M · $0.96/M [1] |
| 上下文/最大輸出 | 1.05M · 131K [5] | 1.05M · 131K [1] |
| 可用性 | 於 2026 年 10 月 21 日退役 [5] | 當前 [1] |
Xiaomi 的發布說明指出 V2.6 “採用與 V2.5 系列相同的 API 定價”,並給 V2.6-Pro 在人工分析智能指數上打了 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 聊天完成格式,因此官方 SDK 無需修改。Anthropic 格式的/v1/messages(測試版)和原生 Gemini 調用可在同一密鑰上使用 [6]。 - 一個密鑰涵蓋多個供應商。
GET /v1/models在設置當天返回了 416 個模型 ID,其中 21 個是 MiMo 變體 [3]。更改模型只需在您的腳本中更改一個字符串。 - 您可以先免費測試。
xiaomi-mimo-v2.6-pro-free在 5 請求/分鐘、100/天和 1M 令牌/天內免費 [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 "用一句話介紹自己。"
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 "用一句話介紹自己。"
我是 MiMo,一個由小米 LLM 核心團隊開發的大型語言模型,旨在協助回答問題、寫作和各種有用的任務。
預期大約六秒後會收到第一個令牌,與模型頁面上列出的 6.4 秒相比 [1]。
5. 根據需要調整
對於非流式調用,刪除 stream=True 並讀取 response.choices[0].message.content。要切換模型,請更改 model 參數。增加 max_tokens 以獲得更長的輸出 — 上述默認的 1024 遠低於模型的限制 [1]。
檢查清單
- [ ] 創建了 Virtualenv;
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 嗎? 是的 — 標準聊天完成。任何兼容 OpenAI 的客戶端都可以通過將基本 URL 設置為 https://aihubmix.com/v1 並將您的 AIHubMix 密鑰作為承載令牌傳遞來使用。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 — 這意味著什麼? 這取決於消息,兩種情況需要相反的處理。“由提供者限制速率”是每分鐘的限制:請等待並重試。“達到免費模型配額的限制”意味著您的帳戶的免費配額已用盡,並在免費模型之間共享 — 重試將無濟於事,因此請切換到 mimo-v2.6-pro。
我收到 400 “目前無法提供服務”。 首先確認 ID 是否與 API 匹配:
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] 變體 ID 和格式說明來自
GET /v1/models端點和 AIHubMix 模型頁面(訪問日期:2026 年 9 月 28 日) - [4] 小米 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 日)



