Як використовувати Xiaomi MiMo v2.6 Pro на AIHubMix: посібник із налаштування

Оновлення (23 жовтня 2026 року): mimo-v2.5-pro було виведено з експлуатації 21 жовтня 2026 року, і AIHubMix більше не приймає запити до цієї моделі. Використовуйте mimo-v2.6-pro — її вартість така сама.

Коротко: спрямуйте офіційний Python SDK openai на https://aihubmix.com/v1, укажіть ID моделі mimo-v2.6-pro і автентифікуйтеся за допомогою ключа AIHubMix. API сумісний з OpenAI (виклики мають той самий формат, що й в OpenAI), тож спеціальний клієнт не потрібен. Налаштування займе близько п’яти хвилин.

Ключові моменти

• API, сумісний з OpenAI — змініть 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+, ключ API AIHubMix

Довідкові значення

Що обрати: v2.6 Pro чи v2.5 Pro?

Обирайте v2.6 Pro. Вона коштує стільки ж і приймає більше типів вхідних даних.

У примітках до випуску Xiaomi сказано, що V2.6 «застосовує ті самі ціни на API, що й серія V2.5», а V2.6-Pro набрала 46 балів в Artificial Analysis Intelligence Index — найвищий результат серед моделей з відкритим кодом на момент написання статті; вона випереджає Kimi K3 і Qwen3.8 Max, але поступається Claude Fable 5.1 і GPT-6 Astra [4]. Найчіткіша теза в примітках про прогрес від покоління до покоління стосується дешевшої моделі: V2.6-Flash «за всіма параметрами перевершила MiMo-V2.5-Pro» [4].

Варто пам’ятати про дві речі. Xiaomi не опублікувала таблицю прямого порівняння V2.6-Pro і V2.5-Pro, тож наведене вище порівняння стосується характеристик і ціни. Крім того, mimo-v2.5-pro мають вивести з експлуатації 21 жовтня 2026 року, а цільовою моделлю для переходу вказано 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 коштує $0 за умови не більш як 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 "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 компанії Xiaomi. Я допомагаю відповідати на запитання, писати тексти й виконувати багато інших корисних завдань.

Очікуйте, що перші токени з’являться приблизно за шість секунд, тоді як на сторінці моделі вказано 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-токен. У документації 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». Спочатку перевірте 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, надавши ідентифікатор запиту з відповіді.

Як визначити, чи проблема на моєму боці, чи на боці постачальника? Викличте модель іншого постачальника з тим самим ключем і скриптом — наприклад, 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 (перевірено 28 вересня 2026 року)
• [2] Сторінка моделі AIHubMix, xiaomi-mimo-v2.6-pro-free: https://aihubmix.com/model/xiaomi-mimo-v2.6-pro-free (перевірено 28 вересня 2026 року)
• [3] ID варіантів і примітки щодо форматів з кінцевої точки GET /v1/models і сторінок моделей AIHubMix (перевірено 28 вересня 2026 року)
• [4] Примітки до випуску Xiaomi MiMo, серія V2.6: https://mimo.mi.com/docs/en-US/news/latest/v2-6 (перевірено 28 вересня 2026 року)
• [5] Сторінка моделі AIHubMix, mimo-v2.5-pro: https://aihubmix.com/model/mimo-v2.5-pro (перевірено 28 вересня 2026 року)
• [6] Документація продукту AIHubMix: https://docs.aihubmix.com/en (перевірено 28 вересня 2026 року)