MiMo M2.5
MiMo M2.5 is the mid-tier model in Xiaomi's MiMo v2.5 family, a Mixture-of-Experts (MoE) stack with reasoning, tool use, and multimodal input. It supports a context window of 1.1M tokens and 131.1K tokens max output tokens. Your use is subject to Xiaomi's Terms & Privacy Policies.
View API reference- Input and output price15% off
- Prices from: Input $0.12, Output $0.24, Per 1M tokens
- 24h uptime
- Loading AI Gateway uptime
import { streamText } from 'ai'
const result = streamText({ model: 'xiaomi/mimo-v2.5', prompt: 'Why is the sky blue?'})Copy link to headingPlayground
Try out MiMo M2.5 by Xiaomi. Usage is billed to your team at API rates. Free users (those who haven't made a payment) get $5 of credits every 30 days.
MiMo M2.5
Copy link to headingProviders
Route requests across multiple providers. Copy a provider slug to set your preference. Visit the docs for more info. Using a provider means you agree to their terms, listed under Legal.
| Provider |
|---|
Copy link to headingUptime24 hours
Direct request success rate on AI Gateway and per-provider. Visit the docs for more info.
Copy link to headingThroughput24 hours
P50 throughput on live AI Gateway traffic, in tokens per second (TPS). Visit the docs for more info.
Copy link to headingLatency24 hours
P50 time to first token (TTFT) on live AI Gateway traffic, in milliseconds. View the docs for more info.
Getting started
Call MiMo M2.5 through AI Gateway with the AI SDK generateText and streamText functions, or through the OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages APIs by changing the base URL. AI Gateway authenticates the request and routes it to an available provider.
Install the AI SDK (pnpm add ai dotenv), create an API key from the API Keys page, and set it as AI_GATEWAY_API_KEY in your environment. Full setup is covered in the text generation quickstart.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'xiaomi/mimo-v2.5', prompt: 'Why is the sky blue?', });
console.log(result.text);}
main().catch(console.error);Top-level parameters
The same MiMo M2.5 request in each API format AI Gateway supports.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'xiaomi/mimo-v2.5', system: 'You are a concise technical assistant.', prompt: 'Summarize the tradeoffs between static generation and SSR.', maxOutputTokens: 1024, });
console.log(result.text);}
main().catch(console.error);Standard parameters like prompt, messages, temperature, and tools work as documented in the AI SDK docs. These are the parameters with model-specific behavior.
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Model ID in the form creator/model, e.g. xiaomi/mimo-v2.5. AI Gateway routes the request to an available provider. |
maxOutputTokens | number | No | Hard cap on generated tokens. MiMo M2.5 supports up to 131,100 output tokens. Reasoning tokens count toward this limit. |
reasoning | 'provider-default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | No | Provider-agnostic reasoning effort, available in AI SDK 7 or later. Maps to the provider’s native reasoning configuration; reasoning settings under providerOptions take precedence when both are set. See the Reasoning section below. |
providerOptions | Record<string, JSONValue> | No | AI Gateway routing options under gateway, plus any provider-native options under the provider’s own namespace — see the table below. |
Input limits
| Input | Formats | Sources | Max count | Max size | Limits |
|---|---|---|---|---|---|
| Text | — | — | — | — | Prompt and response share the 1.1M-token context window |
| Image | — | URL, base64, Uint8Array | — | — | Sent as image parts in messages; counts as input tokens |
Provider options
Set AI Gateway routing options under providerOptions.gateway. For provider-specific options, pass them under the provider’s namespace as documented by the AI SDK.
Learn more in the AI SDK provider docs.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'xiaomi/mimo-v2.5', prompt: 'Why is the sky blue?', providerOptions: { gateway: { only: ['xiaomi', 'deepinfra'], }, }, });
console.log(result.text);}
main().catch(console.error);These AI Gateway routing options apply to every model. Provider-specific options pass through under the provider’s own namespace (for example providerOptions.anthropic) exactly as documented by the AI SDK.
| Parameter | Type | Required | Description |
|---|---|---|---|
providerOptions.gateway.only | string[] | No | Restrict routing to these provider slugs. Requests fail over only within the listed providers. |
providerOptions.gateway.order | string[] | No | Preferred provider order. Listed providers are tried first; unlisted providers remain available as fallbacks. |
providerOptions.gateway.sort | 'cost' | 'ttft' | 'tps' | No | Rank candidate providers by price, time to first token, or tokens per second instead of the default routing order. |
providerOptions.gateway.zeroDataRetention | boolean | No | Route only to providers with a zero-data-retention policy for this model. |
Routing across providers
AI Gateway serves the same model through multiple providers and fails over automatically. order expresses a preference while keeping every provider eligible; only is a hard allowlist — if none of the listed providers are available the request fails instead of falling back.
Options under a provider's own namespace (for example providerOptions.anthropic) are forwarded to that provider with the request. Providers ignore option namespaces that don't apply to them, so it is safe to set provider options alongside gateway routing options.
Reasoning
AI Gateway bridges reasoning across every API format. The AI SDK exposes a provider-agnostic top-level reasoning level (none, minimal, low, medium, high, or xhigh); the Chat Completions and Responses formats take the same effort under reasoning.effort; and the Anthropic Messages format uses a native thinking token budget. Whichever you send, the gateway maps it to the target model’s native configuration, converting between effort levels and token budgets as needed. Reasoning-related settings under providerOptions take full precedence over the top-level reasoning value and are never merged. Reasoning tokens typically count toward your output-token usage, though how they’re reported and billed varies by provider.
Learn more in the AI Gateway reasoning guide.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'xiaomi/mimo-v2.5', prompt: 'Explain the Monty Hall problem step by step.', reasoning: 'high', });
console.log(result.text);}
main().catch(console.error);Image input
Send images alongside text as message parts. Images count as input tokens.
import { generateText } from 'ai';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'xiaomi/mimo-v2.5', messages: [ { role: 'user', content: [ { type: 'text', text: 'Describe this image.' }, { type: 'image', image: 'https://example.com/photo.jpg' }, ], }, ], });
console.log(result.text);}
main().catch(console.error);Tool calling
Expose tools the model can call. Define each tool’s inputs with a Zod schema.
import { generateText, tool } from 'ai';import { z } from 'zod';import 'dotenv/config';
async function main() { const result = await generateText({ model: 'xiaomi/mimo-v2.5', prompt: 'What is the weather in San Francisco?', tools: { getWeather: tool({ description: 'Get the current weather for a location', inputSchema: z.object({ location: z.string() }), execute: async ({ location }) => ({ location, temperatureC: 18 }), }), }, });
console.log(result.text);}
main().catch(console.error);Copy link to headingAbout MiMo M2.5
MiMo M2.5 is a MoE language model from Xiaomi, released April 22, 2026 under the MIT license. Each forward pass activates a subset of total parameters, which keeps per-token compute lower than a dense model at the same parameter count.
The architecture uses hybrid attention, interleaving sliding-window and full attention to cut KV-cache storage at long sequence lengths. A multi-token prediction (MTP) block raises output tokens per step during inference. The full window of 1.1M tokens lets MiMo M2.5 reason over large documents, repos, or long agent trajectories.
MiMo M2.5 supports reasoning, tool calling, file input, vision, and implicit prompt caching. Call it through Xiaomi, DeepInfra, GMICloud via AI Gateway. For the higher-capability tier, see mimo-v2.5-pro.
Copy link to headingWhat To Consider When Choosing a Provider
- Configuration: MiMo M2.5 balances cost, capability, and context length. The MoE design keeps active compute small, but routing and serving a 300B-class MoE still requires capable infrastructure on the provider side. Use AI Gateway's cost tracking and model fallback to mix MiMo M2.5 with
mimo-v2.5-proon harder workloads. - Zero Data Retention: Zero Data Retention is available for this model. It is offered on a per-provider and model basis. See the documentation for details.
- Authentication: AI Gateway authenticates requests using an API key or OIDC token. You do not need to manage provider credentials directly.
Copy link to headingWhen to Use MiMo M2.5
Best for
- Agentic Workflows: Tool-using agents that string together many calls in one session
- Software Engineering: Code generation, refactors, and repo-scale analysis with a window of 1.1M tokens
- Multimodal Input: Reasoning over mixed text, images, and uploaded files
- Long Context: Documents, codebases, or chat histories that approach 1.1M tokens
- Cost-Aware Reasoning: Lower active-parameter compute than dense models at similar scores
Consider alternatives when
- Maximum Reasoning Depth:
mimo-v2.5-proactivates more parameters per step on the hardest math and engineering tasks - Speed-First Throughput:
mimo-v2-flashis the throughput-tuned option in the previous generation - Simple Classification: A smaller, cheaper model handles short extraction at lower cost
- Strict Text Pipelines: A text-only model is fine when your inputs are never images or files
Copy link to headingConclusion
MiMo M2.5 is the standard tier of Xiaomi's MiMo v2.5 family. Use it for agentic workflows, multimodal input, code, and long-context analysis. Pair it with mimo-v2.5-pro through AI Gateway routing so harder jobs land on the higher tier.
Copy link to headingFrequently Asked Questions
How does MiMo M2.5 differ from
mimo-v2.5-pro?MiMo M2.5 is the standard tier.
mimo-v2.5-proactivates a larger share of a larger parameter pool per step, so it costs more but reasons further on harder math, code, and agentic problems.What architecture does MiMo M2.5 use?
A Mixture-of-Experts (MoE) stack with hybrid attention. Each token activates a subset of expert blocks, and sliding-window plus full attention combine to keep KV cache manageable at long context lengths.
What's the context window for MiMo M2.5?
1.1M tokens. Hybrid attention keeps KV-cache memory in check so long-context runs stay practical.
Does MiMo M2.5 support tool calling and reasoning modes?
Yes. MiMo M2.5 supports tool calling and a reasoning mode, both exposed through AI Gateway. Use them through the AI SDK, the Chat Completions API, the Responses API, or any other supported format.
How do I authenticate requests to MiMo M2.5 through AI Gateway?
Add your API key in AI Gateway project settings. Use
xiaomi/mimo-v2.5in API calls. AI Gateway routes, retries, and fails over acrossxiaomi,deepinfra,gmicloud.What does MiMo M2.5 cost?
See the pricing section on this page for today's rates. AI Gateway tracks each provider's pricing for MiMo M2.5, so the numbers shown stay current.
Does MiMo M2.5 support zero data retention?
Yes, Zero Data Retention is available for this model. Zero Data Retention is offered on a per-provider basis. See https://vercel.com/docs/ai-gateway/capabilities/zdr for details.
Is MiMo M2.5 available under an open-source license?
Yes. The MiMo v2.5 line is released under the MIT license, which allows commercial use, modification, and redistribution.