Xiaomi MiMo API: полное руководство по интеграции (2026)

Xiaomi MiMo — семейство open-weight AI-моделей: от бюджетной MiMo V2 Flash (309B total / 15B active параметров) до флагманской MiMo V2.5 Pro (1.02T total / 42B active / 1M контекст). Все модели MiMo доступны через собственную API-платформу Xiaomi platform.xiaomimimo.com с OpenAI-совместимым endpoint — укажите base_url вашего OpenAI SDK на их endpoint, замените model ID, и код работает. MiMo V2.5 Pro привлёк внимание высокими результатами на agentic coding benchmarks — в частности, SWE-bench Verified, где она показывает результаты на уровне frontier proprietary моделей.

Мы написали это руководство, потому что MiMo — последний крупный китайский AI-провайдер в нашем routing layer, для которого не было отдельного integration guide. Мы маршрутизируем пять моделей MiMo — от sub-dollar flash модели до trillion-parameter reasoning флагмана — MiMo покрывает более широкий диапазон задач, чем большинство линеек одного провайдера.

OpenAI-совместимость означает, что провайдер предоставляет endpoint chat-completions, чей контракт запроса и ответа достаточно близок к API OpenAI, чтобы немодифицированный вызов OpenAI SDK работал после замены трёх значений: API key, base URL, название модели. Минимальная поверхность на практике —POST /v1/chat/completions с messages, model и потоковым ответом в форме OpenAI.

Быстрый старт за 3 минуты

Шаг 1: Регистрация. Перейдите на platform.xiaomimimo.com и создайте аккаунт. Xiaomi поддерживает email, номер телефона и OAuth.

Шаг 2: Получите API key. В консоли перейдите в раздел API Keys и создайте новый ключ. Скопируйте его — ключ показывается только один раз.

Шаг 3: Первый вызов. Установите OpenAI Python SDK:

pip install --upgrade openai

Запустите:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_MIMO_API_KEY",
    base_url="https://api.mimo.mi.com/v1",
)

response = client.chat.completions.create(
    model="mimo-v2.5-pro",
    messages=[{"role": "user", "content": "Объясни одним абзацем, что такое MiMo V2.5 Pro."}],
)

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

Готово. Новые аккаунты получают бесплатный пробный баланс — проверьте доступные кредиты в консоли. Xiaomi также предлагает подписку Token Plan для предсказуемых ежемесячных расходов.

Семейство моделей MiMo

MiMo включает пять моделей — text, multimodal и speech:

Все text-generation модели поддерживают стандартный OpenAI /v1/chat/completions endpoint. MiMo V2.5 ASR использует /v1/audio/transcriptions.

MiMo V2.5 Pro — флагман

MiMo V2.5 Pro — сильнейшая модель Xiaomi. Выпущена 23 апреля 2026 года: 1.02T параметров, Mixture-of-Experts, 42B active параметров, контекст 1M tokens. Гибридная архитектура attention — Sliding Window Attention (SWA) чередуется с Global Attention в соотношении 6:1 — сокращает KV-cache почти в 7 раз на длинном контексте, сохраняя качество.

Ключевые возможности:

• Agentic coding: 62% на SWE-bench Pro через MiMo Code (harness Xiaomi), 78.6% на SWE-bench Verified в thinking mode (источник: Xiaomi, апрель 2026)
• Long-horizon задачи: поддерживает сложные задачи с 1,000+ tool calls — Xiaomi продемонстрировала полный SysY compiler на Rust за 4.3 часа, 233/233 на скрытом test suite PKU
• Token efficiency: frontier-tier результат при 40–60% меньшем расходе tokens на trajectory (ClawEval)
• Open weights: полностью open-source на Hugging Face под permissive license

Reasoning mode включается опционально: через reasoning_effort, Anthropic-style thinking block или параметр enable_thinking.

MiMo V2 Flash — бюджетный reasoning

MiMo V2 Flash — MoE с 309B total / 15B active параметров, оптимизирован для скорости и стоимости. Через TheRouter: $0.14/MTok input, $0.43/MTok output — одна из самых дешёвых reasoning-capable моделей. Поддерживает thinking mode (opt-in), tool calls, JSON output. После обновления февраля 2026: 78.6 на SWE-bench Verified в thinking mode (источник: Xiaomi, февраль 2026).

V2 Flash также глубоко интегрирован с coding agents — Xiaomi специально оптимизировала его для Claude Code, OpenCode, Kilo и Cline.

MiMo V2.5 — multimodal mid-tier

MiMo V2.5 — мультимодальный вариант. Принимает text, images, audio и video, поддерживает reasoning mode. Pricing: ¥1/MTok input / ¥2/MTok output — хороший выбор, когда нужен cross-modal understanding без цены флагмана. По данным Xiaomi, agent-возможности на повседневных задачах «сопоставимы с V2.5 Pro».

MiMo V2.5 ASR — speech transcription

MiMo V2.5 ASR — speech-to-text:

• Китайский и английский, code-switching
• Региональные диалекты (Wu, Cantonese, Minnan, Sichuanese)
• Транскрипция lyrics в mixed vocal-instrumental tracks
• Устойчивая работа в шумных, far-field и multi-speaker условиях

Pricing: ¥0.50/час input audio. Endpoint: /v1/audio/transcriptions.

Доступ к API: прямой vs. routing

Модели MiMo доступны несколькими путями:

1. Xiaomi MiMo Platform (прямой): основной API на api.mimo.mi.com. Совместим с OpenAI и Anthropic протоколами.
2. Сторонние провайдеры: доступны на OpenRouter, SiliconFlow и других агрегаторах.
3. TheRouter: мы маршрутизируем MiMo через провайдер xiaomi, с поддержкой fallback chains между провайдерами.

Для пользователей DashScope: модели MiMo не размещены на Alibaba Cloud DashScope (Bailian). Они работают на собственной инфраструктуре Xiaomi. Если вы уже используете DashScope для Qwen, добавление MiMo означает второго провайдера — именно тот сценарий, где routing layer приносит пользу.

Примеры кода

Базовый chat completion

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_MIMO_API_KEY",
    base_url="https://api.mimo.mi.com/v1",
)

response = client.chat.completions.create(
    model="mimo-v2.5-pro",
    messages=[
        {"role": "system", "content": "Ты — полезный ассистент для программирования."},
        {"role": "user", "content": "Напиши Python-функцию для слияния двух отсортированных списков."},
    ],
    temperature=0.7,
    max_tokens=2048,
)

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

Thinking mode (reasoning)

response = client.chat.completions.create(
    model="mimo-v2.5-pro",
    messages=[{"role": "user", "content": "Докажи, что √2 — иррациональное число."}],
    extra_body={"enable_thinking": True},
)

# Ответ включает reasoning в thinking block
print(response.choices[0].message.content)

Tool calling

import json

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Получить текущую погоду для города",
            "parameters": {
                "type": "object",
                "properties": {
                    "location": {"type": "string", "description": "Название города"},
                },
                "required": ["location"],
            },
        },
    }
]

response = client.chat.completions.create(
    model="mimo-v2.5-pro",
    messages=[{"role": "user", "content": "Какая погода в Пекине?"}],
    tools=tools,
    tool_choice="auto",
)

tool_call = response.choices[0].message.tool_calls[0]
print(f"Function: {tool_call.function.name}")
print(f"Args: {tool_call.function.arguments}")

Tool calling accuracy в thinking mode достигла 97% после обновления V2 Flash в феврале 2026, по сравнению с 44% при запуске (источник: Xiaomi).

Multimodal input (V2.5 / V2.5 Pro)

response = client.chat.completions.create(
    model="mimo-v2.5",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Опиши, что ты видишь на этом изображении."},
                {
                    "type": "image_url",
                    "image_url": {"url": "https://example.com/photo.jpg"},
                },
            ],
        }
    ],
)

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

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_MIMO_API_KEY",
  baseURL: "https://api.mimo.mi.com/v1",
});

const completion = await client.chat.completions.create({
  model: "mimo-v2.5-pro",
  messages: [{ role: "user", content: "Объясни архитектуру MoE." }],
});

console.log(completion.choices[0].message.content);

Pricing

MiMo предлагает конкурентные цены, особенно после снижения до 99% на некоторых тарифах в мае 2026:

Xiaomi также предлагает подписку Token Plan — $1,056/год ($88/месяц) с пулом кредитов в 5–8× больше, чем pay-as-you-go.

Актуальные цены через TheRouter routing layer — на странице модели MiMo V2.5 Pro.

Частые ошибки и решения

Чеклист перед продакшеном

Перед production-деплоем с MiMo:

• Ротация API key: храните ключи в environment variables или secrets manager, не в коде
• Rate limit handling: exponential backoff с jitter на 429
• Выбор модели: V2 Flash для throughput, V2.5 Pro для quality
• Context budget: cache hit V2.5 Pro (¥0.025/MTok) в 120× дешевле cache miss — структурируйте prompts для максимизации cache hits повторяющихся system prompts
• Timeout: long-horizon agentic задачи могут длиться минуты — настройте адекватные таймауты
• Fallback routing: настройте backup provider на случай недоступности Xiaomi
• Response validation: для tool calls валидируйте аргументы функций перед выполнением
• Cost monitoring: отслеживайте потребление tokens — thinking mode генерирует дополнительные reasoning tokens, которые учитываются в output billing

TheRouter integration

Мы маршрутизируем все пять моделей MiMo через провайдер xiaomi. Если вы уже используете TheRouter:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_THEROUTER_KEY",
    base_url="https://therouter.ai/v1",
)

response = client.chat.completions.create(
    model="xiaomi/mimo-v2.5-pro",
    messages=[{"role": "user", "content": "Привет из MiMo через TheRouter!"}],
)

TheRouter поддерживает model fallback chains — настройте MiMo V2.5 Pro как primary coding model с автоматическим fallback на DeepSeek V4 Pro или Claude Opus при недоступности Xiaomi. Это особенно полезно, учитывая, что API-платформа MiMo новее и может иметь меньше redundancy, чем зрелые провайдеры.

Полный список моделей MiMo и актуальный pricing через TheRouter:

• MiMo V2.5 Pro
• MiMo V2.5
• MiMo V2 Flash
• MiMo V2 Pro
• MiMo V2.5 ASR

MiMo vs. другие китайские AI-провайдеры

Если вы сравниваете MiMo с другими китайскими AI model API:

• vs. DeepSeek V4: MiMo V2.5 Pro конкурентна по coding benchmarks, но дороже DeepSeek V4 Flash. Преимущество MiMo — multimodal input и open weights. См. DeepSeek API guide.
• vs. Qwen3.7 (DashScope): Qwen3.7 Max сильнее в общем reasoning, но MiMo V2.5 Pro превосходит на long-horizon agentic задачах. MiMo — собственная платформа; Qwen работает через DashScope. См. DashScope Qwen3.7 guide.
• vs. Kimi K2.7 Code: оба нацелены на agentic coding. K2.7 Code — специалист от Moonshot AI; MiMo V2.5 Pro — универсал, также отличный в coding. См. Kimi K2 guide.
• vs. GLM-5 (Z.AI): GLM-5 силён на long-horizon coding benchmarks. MiMo V2.5 Pro предлагает сравнимую agent-производительность с open weights. См. GLM API guide.

Ключевое отличие MiMo: единственная frontier-tier китайская модель, которая и доступна через API, и полностью open-source с permissive weights на Hugging Face.

FAQ

MiMo бесплатен? Новые аккаунты получают бесплатные trial credits. Далее — pay-as-you-go или подписка Token Plan. MiMo V2.5 TTS временно бесплатен.

MiMo поддерживает streaming? Да. Передайте stream=True в API call, как в OpenAI SDK.

Можно self-host MiMo? Да. Weights MiMo V2.5 Pro и V2 Flash доступны на Hugging Face. Деплойте через SGLang или vLLM — см. model card для конфигурации.

Какие coding agents работают с MiMo? MiMo протестирован с Claude Code, OpenCode, OpenClaw, Kilo Code, Cline, Codex, Cherry Studio, Qwen Code и CodeBuddy. Xiaomi также предлагает собственный MiMo Code harness.

MiMo поддерживает function calling / tool use? Да. Все text-generation MiMo модели поддерживают OpenAI tool calling формат. После обновления февраля 2026: tool call accuracy в thinking mode — 97%.

Какие языки поддерживает MiMo V2.5 ASR? Китайский, английский, code-switching между ними, а также несколько китайских диалектов: Wu, Cantonese, Minnan и Sichuanese.