Host e credencial
Requisições OpenAI pré-pagas usam https://api.xiaomimimo.com/v1 e o cabeçalho api-key. O Token Plan usa seu host e a credencial tp-xxxxx.
Português
MIMO 2.5 PRO API
Corrija a conexão do MiMo 2.5 Pro campo a campo
Uma requisição válida precisa do host correto da Xiaomi, do cabeçalho api-key, do ID exato do modelo e de um corpo aceito pelo MiMo. Comece pelos sintomas e depois confira thinking, streaming, contexto e provedor.
Documentação oficial conferida em 27/08/2026. O MiMo-V2.5-Pro não aparece no seletor atual do Tabbit, que é apresentado como uma rota independente com modelos compatíveis.
O QUE A DOCUMENTAÇÃO DIZ
A maioria dos erros é uma divergência de contrato
A Xiaomi documenta duas famílias de Base URL, um ID de modelo e compatibilidade com OpenAI e Anthropic. Resultados da comunidade citam rejeições de provedores e chamadas que gastam tokens de entrada sem uma saída útil, mas isso não é garantia de serviço.
Modelo e corpo
O exemplo oficial usa mimo-v2.5-pro e /chat/completions. Valide messages antes de mudar amostragem ou campos de agente.
Raciocínio é estado
O pensamento profundo retorna reasoning_content. Em chamadas de ferramenta com vários turnos, a Xiaomi pede o reenvio completo do campo ou a API pode retornar 400.
REQUISIÇÃO MÍNIMA
Comece com curl antes de ajustar o SDK
Esta é a forma compatível com OpenAI da documentação, reduzida aos campos que confirmam a rota. Mantenha a chave em uma variável de ambiente.
BASE COPIÁVEL
curl --location --request POST 'https://api.xiaomimimo.com/v1/chat/completions' \
--header "api-key: $MIMO_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{"model":"mimo-v2.5-pro","messages":[{"role":"user","content":"Hello"}],"max_completion_tokens":1024,"stream":false}'O exemplo oficial também mostra max_completion_tokens, temperature 1.0, top_p 0.95, stream false e campos de penalidade. O pensamento profundo pode impor os valores recomendados.
- 01
Escolha a rota da conta
Para pagamento por uso, use https://api.xiaomimimo.com/v1. Para Token Plan, substitua pelo Base URL exclusivo mostrado após a assinatura.
- 02
Envie a autenticação Xiaomi
Use api-key: $MIMO_API_KEY e Content-Type: application/json. Nem todo cliente OpenAI converte Authorization para o cabeçalho documentado.
- 03
Use o ID exato
Defina model como mimo-v2.5-pro. Um gateway pode publicar outro slug, então copie o ID atual do catálogo.
- 04
Comece com um turno do usuário
Envie uma única mensagem user. Adicione tools, thinking e stream depois de receber uma completion válida.
RACIOCÍNIO, STREAMING E CONTEXTO
Três controles que mudam a resposta
Use o comportamento da API como teste. Uma resposta final vazia pode ocorrer porque o cliente lê apenas content enquanto o texto está em reasoning_content, ou porque o pensamento consumiu o orçamento.
thinking.type
Envie {"type":"enabled"} ou {"type":"disabled"}. A Xiaomi lista mimo-v2.5-pro e mimo-v2.5 como ativados por padrão. No SDK Python, coloque o campo não padrão em extra_body.
stream e finalização
Com streaming, os fragmentos reasoning_content chegam primeiro e os de content depois. Acumule ambos, pare em finish_reason e trate o fragmento usage antes de [DONE].
Contexto e orçamento
Não invente um número de janela de contexto que não esteja documentado. Mantenha messages dentro do limite atual do modelo e da conta. max_completion_tokens cobre pensamento e resposta final.
A Xiaomi diz que temperature e top_p personalizados não são efetivos no pensamento profundo. Os valores recomendados são 1.0 e 0.95. Confira a resposta real do servidor.
DIFERENÇAS DE ROTA
API oficial, Token Plan e gateways são contratos diferentes
Compatibilidade com OpenAI descreve o formato da requisição, não cobrança, aliases, cabeçalhos, cotas, moderação ou streaming. Registre o host e o provedor em cada falha.
| Verificação | Xiaomi oficial | Gateway ou provedor |
|---|---|---|
| Base OpenAI | https://api.xiaomimimo.com/v1 | Use o Base URL atual do provedor |
| Token Plan | https://token-plan-cn.xiaomimimo.com/v1 com tp-xxxxx | Normalmente não é intercambiável com a chave por uso |
| Campo model | mimo-v2.5-pro | Copie o slug exato do catálogo |
| Auth | api-key: MIMO_API_KEY | Siga o cabeçalho e formato do provedor |
| Limites e política | Consulte uso e console da Xiaomi | Consulte cota, moderação, RPM, TPM e concorrência |
LISTA DE CÓDIGOS
Use o código para reduzir a busca
Mude uma variável por vez. Salve host, modelo, corpo da resposta e horário antes de tentar novamente.
Corpo malformado, campo não suportado, messages inválido ou histórico de ferramenta sem reasoning_content.
Reproduza a requisição mínima e confira JSON, model, messages, posição de thinking e reenvio completo de reasoning_content.
Chave ausente, expirada, com prefixo errado ou no cabeçalho errado.
Carregue a chave de uma variável de ambiente e use api-key. Nunca mostre o segredo.
A conta ou rota não tem permissão, ou uma política do gateway rejeitou a requisição.
Confirme conta, host do plano, acesso ao modelo, política do provedor e moderação.
O caminho do host ou alias do modelo não existe.
Verifique /v1/chat/completions, o Base URL e o catálogo atual. Não acrescente /v1 duas vezes.
Limite de velocidade, tokens, concorrência ou cota excedido.
Confira os limites ativos, aplique backoff com jitter e reduza chamadas paralelas.
A requisição termina sem content ou o stream parece travado.
Registre cada delta, reasoning_content e finish_reason. Aumente max_completion_tokens, revise o parser e teste thinking disabled.
UMA ROTA DE NAVEGADOR SEM API
Use o Tabbit para a página, não para a tubulação de credenciais
O seletor atual do Tabbit não mostra o MiMo-V2.5-Pro. Não há uma integração de um clique a prometer. Para pesquisar páginas ou comparar respostas, escolha um modelo realmente listado e mantenha esse fluxo separado do diagnóstico de API.
01
Escolha um modelo listado
O seletor da nova aba mostra os modelos disponíveis. Não é preciso criar uma chave Xiaomi ou copiar um Base URL.
02
Traga o contexto web
Pergunte sobre a página atual ou referencie páginas e arquivos pelo navegador. É um problema diferente de enviar uma requisição bruta.
03
Compare respostas
O Tabbit pode mostrar respostas de modelos compatíveis lado a lado e usar Deep Research para reunir fontes e passos.
QUAL ROTA ESCOLHER
Controle da API versus contexto do navegador
MiMo pela Xiaomi é adequado quando você controla a integração. O Tabbit é mais direto para trabalhar com páginas usando um modelo compatível.
| Necessidade | MiMo API | Tabbit |
|---|---|---|
| Credenciais | Criar e proteger uma chave Xiaomi ou do provedor | Usar os modelos do seletor |
| Controle | Escolher host, modelo, corpo, raciocínio, ferramentas e stream | Perguntar pelo contexto do navegador |
| Estado da ferramenta | Preservar reasoning_content do assistant | Não repetir mensagens da API manualmente |
| Pesquisa web | Construir busca, fetch e citações | Usar páginas e Deep Research |
FAQ DA API MIMO
Perguntas depois da primeira falha
Qual é o endpoint oficial do MiMo 2.5 Pro?+
Para compatibilidade OpenAI por uso, a Xiaomi documenta https://api.xiaomimimo.com/v1 e /chat/completions. O Token Plan tem outro Base URL.
Qual cabeçalho de API Key a Xiaomi documenta?+
O curl oficial usa api-key: $MIMO_API_KEY. Guarde a chave em uma variável de ambiente e confira as exigências do gateway.
Qual ID de modelo devo enviar?+
O exemplo da Xiaomi usa mimo-v2.5-pro. Um gateway pode publicar outro alias, então use o ID exato do catálogo.
Como ativo ou desativo o pensamento profundo?+
Envie thinking.type como enabled ou disabled. No SDK Python, use extra_body. A Xiaomi diz que os dois modelos V2.5 vêm ativados.
Por que a resposta final está vazia ou lenta?+
O pensamento consome orçamento e aumenta a latência. No streaming, reasoning_content chega antes de content. Acumule ambos e verifique finish_reason.
Por que uma chamada de ferramenta seguinte retorna 400?+
Com pensamento e ferramentas, a Xiaomi pede o reenvio de todo reasoning_content na mensagem assistant seguinte. Sem ele, o contexto fica incompleto.
O MiMo tem uma janela de contexto fixa para copiar?+
Não copie um número não confirmado de uma página de terceiros. Confira os limites atuais do modelo e da conta e deixe espaço para pensamento e resposta.
Posso usar o MiMo-V2.5-Pro diretamente no Tabbit?+
Ele não está no seletor atual. Use Xiaomi ou um gateway para a API e um modelo listado no Tabbit para pesquisa web.
Pronto para parar de adivinhar o próximo 400?
Reproduza a requisição mínima da Xiaomi e adicione thinking, tools e streaming um por vez. Para páginas, use um modelo compatível do Tabbit sem criar uma chave API.
A disponibilidade e os limites podem mudar. Revise a documentação oficial antes de publicar.