Como usar o Xiaomi MiMo v2.6 Pro no AIHubMix: guia de configuração

Atualização (23 de outubro de 2026): mimo-v2.5-pro foi descontinuado em 21 de outubro de 2026, e o AIHubMix não aceita mais solicitações para ele. Use mimo-v2.6-pro, que custa o mesmo.

Em resumo: configure o SDK oficial openai para usar https://aihubmix.com/v1, informe o ID do modelo mimo-v2.6-pro e autentique-se com sua chave do AIHubMix. A API é compatível com a OpenAI (pode ser chamada no mesmo formato da OpenAI), portanto não é necessário um cliente especial. A configuração leva cerca de cinco minutos.

Pontos principais

• API compatível com a OpenAI — altere base_url, e nada mais
• Pago mimo-v2.6-pro · grátis xiaomi-mimo-v2.6-pro-free [1] [2]
• $0.48/M de entrada · $0.96/M de saída [1]
• Plano gratuito 5 solicitações/min · 100/dia · 1M tokens/dia [2]
• Contexto 1.05M tokens · saída máx. 131K tokens [1]
• Requisitos: Python 3.9+, uma chave de API do AIHubMix

Valores de referência

Você deve usar o v2.6 Pro ou o v2.5 Pro?

Use o v2.6 Pro. Custa o mesmo e aceita mais tipos de entrada.

As notas de lançamento da Xiaomi dizem que o V2.6 “adota os mesmos preços de API da série V2.5” e atribuem ao V2.6-Pro 46 pontos no Artificial Analysis Intelligence Index — a maior pontuação entre os modelos de código aberto na época da redação, acima do Kimi K3 e do Qwen3.8 Max e abaixo do Claude Fable 5.1 e do GPT-6 Astra [4]. A comparação mais clara entre gerações nas notas é sobre o modelo mais barato: o V2.6-Flash “superou amplamente o MiMo-V2.5-Pro” [4].

Dois pontos a ter em mente. A Xiaomi não publicou uma tabela de benchmarks que compare diretamente o V2.6-Pro com o V2.5-Pro, então a comparação acima se baseia nas especificações e nos preços. Além disso, mimo-v2.5-pro será descontinuado em 21 de outubro de 2026, e mimo-v2.6-pro foi indicado como destino da migração [5]; portanto, qualquer novidade criada com o v2.5 precisaria ser migrada quase imediatamente.

Por que usar o AIHubMix

• Basta alterar base_url. O gateway usa o formato Chat Completions da OpenAI, então o SDK oficial funciona sem modificações. O formato Anthropic /v1/messages (beta) e chamadas nativas do Gemini também estão disponíveis com a mesma chave [6].
• Uma chave dá acesso a muitos fornecedores. GET /v1/models retornou 416 IDs de modelos no dia da configuração, 21 deles variantes do MiMo [3]. Para mudar de modelo, basta alterar uma string no script.
• Você pode testar gratuitamente primeiro. xiaomi-mimo-v2.6-pro-free custa $0 dentro dos limites de 5 solicitações/min, 100/dia e 1M tokens/dia [2] — o suficiente para confirmar que a configuração funciona antes de gastar qualquer coisa.
• Sem assinatura. A cobrança é por uso, sem associação nem taxa mensal [6], e a tarifa do MiMo pago corresponde à indicada na página do modelo: $0.48/M de entrada e $0.96/M de saída [1].
• A depuração é mais rápida. Se uma chamada falhar, direcione o mesmo script para o modelo de outro fornecedor. Se funcionar, sua chave, URL e formato da solicitação estão corretos, e o problema está no modelo — uma chamada em vez de uma tarde inteira.

Como configurar

1. Crie o projeto

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

2. Armazene sua chave

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

Nunca insira a chave diretamente no script nem faça commit de .env.

3. Crie o cliente

Salve como 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()

Mantenha as duas verificações dentro do loop. Alguns blocos chegam com um array choices vazio, o que gera IndexError ao tentar acessar um índice; delta.content é None no primeiro e no último quadro, e print exibiria None como texto literal.

4. Execute

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

Sou o MiMo, um modelo de linguagem de grande porte desenvolvido pela equipe LLM Core Team da Xiaomi, e estou aqui para ajudar com respostas a perguntas, escrita e uma ampla variedade de tarefas úteis.

Espere cerca de seis segundos até os primeiros tokens, em comparação com os 6.4s indicados na página do modelo [1].

5. Ajuste conforme necessário

Para uma chamada sem streaming, remova stream=True e leia response.choices[0].message.content. Para trocar de modelo, altere o argumento model. Aumente max_tokens para obter uma saída mais longa — o valor padrão de 1024 usado acima está bem abaixo do limite do modelo [1].

Lista de verificação

• [ ] Ambiente virtual criado; openai e python-dotenv instalados
• [ ] .env contém sua chave real, chmod 600
• [ ] .env incluído em .gitignore
• [ ] base_url é https://aihubmix.com/v1 — o /v1 é obrigatório
• [ ] O ID do modelo é mimo-v2.6-pro (pago) ou xiaomi-mimo-v2.6-pro-free (gratuito)
• [ ] O loop de streaming verifica chunk.choices e delta.content
• [ ] Uma chamada de teste retorna texto

Perguntas frequentes

A API é mesmo compatível com a OpenAI? Sim — usa o formato padrão Chat Completions. Qualquer cliente compatível com a OpenAI funciona se você definir a URL base como https://aihubmix.com/v1 e passar sua chave do AIHubMix como token bearer. A documentação do AIHubMix observa que coding-xiaomi-mimo-v2.6-flash é compatível apenas com formatos da OpenAI [3].

Qual ID de modelo devo usar? mimo-v2.6-pro para o plano pago, xiaomi-mimo-v2.6-pro-free para o gratuito. Os dois planos usam convenções de nomenclatura diferentes — as variantes gratuitas levam o prefixo xiaomi- e as pagas não, o que é fácil de confundir.

Que outras variantes estão disponíveis? mimo-v2.6-pro-ultraspeed, mimo-v2.6-flash, mimo-v2.5-pro e IDs ajustados para programação, como coding-xiaomi-mimo-v2.6-pro [3]. Liste-os pela 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)
"

Recebo 429 — o que significa? Depende da mensagem; os dois casos exigem ações opostas. “rate limited by provider” indica um limite por minuto: aguarde e tente novamente. “reached the limit of the free model quota” significa que a cota gratuita da sua conta foi esgotada e é compartilhada entre os modelos gratuitos — tentar novamente não vai resolver, então mude para mimo-v2.6-pro.

Recebo 400 “cannot be served at the moment”. Primeiro, confirme o ID pela 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']])"

Se isso imprimir True, repita a chamada de chat com curl e procure "code": "no_available_channel". Isso significa que o modelo está listado, mas não há capacidade disponível no provedor naquele momento — uma condição do lado do provedor que nenhuma alteração local resolverá. Aguarde ou entre em contato com o suporte do AIHubMix informando o ID da solicitação retornado.

Como posso saber se o problema é meu ou do provedor? Chame o modelo de outro fornecedor usando a mesma chave e o mesmo script — por exemplo, gpt-4o-mini. Se funcionar, sua chave, URL base e formato da solicitação estão corretos, e o problema está nesse modelo específico. Se também falhar, verifique sua chave e o faturamento.

Por que a saída é cortada no meio da frase? Você atingiu max_tokens, não o limite do modelo. Aumente esse valor.

Como verifico o status da minha conta?

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

Verifique has_payment_method e os campos de limite.

Próximas etapas

O script acima é uma base funcional. Entre os recursos listados do MiMo v2.6 Pro estão chamadas de ferramentas, saídas estruturadas, entrada de visão e áudio e cache de prompts [1] — tudo pela mesma interface compatível com a OpenAI, então estender o cliente consiste principalmente em adicionar parâmetros padrão. Comece pelo plano gratuito para confirmar sua configuração e, em seguida, mude o ID do modelo para mimo-v2.6-pro para uso regular.

Fontes

• [1] Página do modelo no AIHubMix, mimo-v2.6-pro: https://aihubmix.com/model/mimo-v2.6-pro (consultada em 28 de setembro de 2026)
• [2] Página do modelo no AIHubMix, xiaomi-mimo-v2.6-pro-free: https://aihubmix.com/model/xiaomi-mimo-v2.6-pro-free (consultada em 28 de setembro de 2026)
• [3] IDs das variantes e notas sobre formatos, obtidos no endpoint GET /v1/models e nas páginas de modelos do AIHubMix (consultados em 28 de setembro de 2026)
• [4] Notas de lançamento do Xiaomi MiMo, série V2.6: https://mimo.mi.com/docs/en-US/news/latest/v2-6 (consultadas em 28 de setembro de 2026)
• [5] Página do modelo no AIHubMix, mimo-v2.5-pro: https://aihubmix.com/model/mimo-v2.5-pro (consultada em 28 de setembro de 2026)
• [6] Documentação do produto AIHubMix: https://docs.aihubmix.com/en (consultada em 28 de setembro de 2026)