Como Usar os Modelos Gratuitos do AIHubMix no JanitorAI: Configuração do Proxy e Erros Comuns

O JanitorAI pode se comunicar com qualquer API compatível com OpenAI através da opção Proxy, e o AIHubMix é uma delas. A configuração completa consiste em quatro valores digitados em um único formulário:

Nome:       qualquer coisa que você quiser, por exemplo, AIHubMix MiMo
URL do Proxy:  https://aihubmix.com/v1/chat/completions
Chave da API:    sua chave do AIHubMix
Modelo:      xiaomi-mimo-v2.6-pro-free

Deixe Custom prompt vazio, pressione Testar, depois Adicionar e atualize a página. É isso.

A maioria das falhas relatadas na comunidade do JanitorAI vem de um desses quatro campos sendo ligeiramente incorretos, ou da camada gratuita esgotando-se mais cedo do que o esperado. Este guia passa pela configuração uma vez, depois cobre cada erro que você provavelmente verá e o que fazer a respeito.

Antes de começar

Você precisa de três coisas:

1. Uma conta no AIHubMix e uma chave da API. Inscreva-se, depois crie uma chave na página da chave da API do AIHubMix. Copie-a para um lugar seguro imediatamente.
2. Um bot que permite proxies. Um proxy só funciona com bots que mostram "proxy permitido" acima do seletor de persona ou do botão de iniciar chat, como explica este guia de proxy da comunidade. Bots com definições de personagens visíveis geralmente permitem isso.
3. Um ID de modelo. Escolha um da lista de modelos gratuitos do AIHubMix e copie seu ID exatamente. O favorito atual da comunidade para interpretação de papéis é xiaomi-mimo-v2.6-pro-free; o guia de modelos nesta série compara as opções.

Uma coisa a saber antes da sua primeira mensagem: uma nova conta recebe 10 chamadas de teste no total, compartilhadas entre todos os modelos gratuitos. Após um recarregamento único de $1 ou mais, a conta muda para cotas diárias (100 solicitações por dia, 10 por minuto, 1M tokens por dia). O guia de limites nesta série explica até onde isso vai em um chat longo.

Os quatro valores e onde as pessoas erram

O ID do modelo vai no campo Modelo. Ele é em letras minúsculas e mantém seu sufixo -free. "Xiaomi Mimo V2.6 Pro (grátis)" é o nome de exibição e não funcionará; xiaomi-mimo-v2.6-pro-free funcionará.

Ao lado do rótulo URL do Proxy, há um botão Adicionar /chat/completions. Ele apenas anexa /chat/completions ao que já está no campo. Se você colou a URL completa acima, não clique nele, ou o caminho acabará duas vezes. Se você colou https://aihubmix.com/v1, um clique completa.

O campo da chave da API diz "(opcional)". Preencha-o de qualquer maneira: sem uma chave, cada solicitação é rejeitada.

Custom prompt substitui o prompt do sistema para este proxy e é enviado no topo de cada solicitação enquanto o proxy estiver ativo. O AIHubMix não precisa de um, então deixe-o vazio.

Configure no JanitorAI

O JanitorAI redesenhou suas configurações de chat em 19 de julho de 2026, então vídeos mais antigos mostram telas diferentes. Os passos abaixo foram verificados contra a versão web atual em outubro de 2026:

1. Abra um chat com um bot que permite proxy.
2. Abra o menu no canto superior direito e escolha Configurações.
3. Em Provedor, escolha Proxy.
4. Em Configurações do Proxy, clique em + Novo.
5. No formulário Nova Configuração, preencha Nome, URL do Proxy, Chave da API e Modelo com os valores acima. Deixe Custom prompt vazio.
6. Clique em Testar. Se a configuração funcionar, nada aparecerá; uma mensagem aparece apenas quando algo está errado.
7. Clique em Adicionar, depois atualize a página ou reinicie o chat.

A atualização no passo 7 é o passo que as pessoas mais pulam. Até que a página recarregue, o JanitorAI pode continuar enviando mensagens através da configuração antiga.

Você pode salvar várias configurações, por exemplo, uma por modelo, o que torna a troca rápida quando um modelo está ocupado. Para adicionar um backup, abra uma configuração salva, clique em Duplicar e mude apenas o campo Modelo.

Configurações para seu primeiro chat

Abra o menu → Configurações novamente e olhe para os controles de geração. Dois deles são importantes para uma primeira execução, de acordo com o guia da Arcanum RPGs sobre o painel atual:

• Tamanho do contexto. Com um modelo externo, o controle deslizante vai até 128.000 tokens. Comece entre 16.000 e 32.000. O próprio tooltip do JanitorAI diz para reduzi-lo se as respostas não forem geradas.
• Tokens máximos. 0 permite que o modelo escolha o comprimento da resposta. Qualquer outro número é um limite rígido, então um valor baixo pode cortar respostas no meio da frase.

Pressione Salvar; nada se aplica até você fazer isso.

O tamanho do contexto é importante para mais do que a qualidade. Cada turno envia todo o contexto novamente, e todos os modelos gratuitos compartilham um pool de 1M tokens por dia. Uma vez que um chat preencha um contexto de 32.000 tokens, esse pool cobre aproximadamente 30 respostas, bem abaixo do limite de 100 solicitações. O guia de limites nesta série trabalha com os números.

Opcional: teste sua chave fora do JanitorAI

Se você se sentir confortável com um terminal, esta solicitação separa "minha chave está errada" de "minha configuração do JanitorAI está errada". Ela usa o mesmo endpoint que a documentação de início rápido do AIHubMix e consome uma solicitação (uma das suas 10 chamadas de teste se você não tiver recarregado).

export AIHUBMIX_API_KEY="cole-sua-chave-aqui"

curl https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "xiaomi-mimo-v2.6-pro-free", "messages": [{"role": "user", "content": "Diga olá em cinco palavras."}]}'

Uma resposta com texto significa que a chave e o ID do modelo estão corretos, e o problema está nos campos do JanitorAI ou na falta de atualização.

Erros comuns e como corrigi-los

"Erro de rede" ou "Falha ao buscar"

O teste mostra "Erro de rede. Tente novamente mais tarde!", ou o chat mostra "Ocorreu um erro de rede, você pode estar limitado por taxa ou ter problemas de conexão: Falha ao buscar".

• Por que: A solicitação nunca chegou ao AIHubMix, ou a resposta nunca voltou para o seu navegador. Apesar da redação, "Falha ao buscar" aponta para um problema de conexão, não uma cota. A causa usual é um VPN ou proxy que bloqueia ou redireciona incorretamente aihubmix.com; uma extensão do navegador que filtra solicitações pode fazer o mesmo. No teste do AIHubMix com este guia, um VPN foi a causa.
• Correção: Desligue o VPN, mude para outro servidor ou certifique-se de que ele permite a passagem do aihubmix.com. Pause extensões de bloqueio de anúncios ou privacidade em janitorai.com. Depois, pressione Testar novamente.

O teste mostra um erro, ou o bot nunca responde

• Por que: A URL do Proxy está incompleta (apenas URL base ou homepage), tem um erro de digitação, ou termina em /chat/completions duas vezes porque o botão Adicionar /chat/completions foi clicado após colar a URL completa. O AIHubMix responde a um caminho errado com "O endpoint da API solicitado não existe."
• Correção: Cole https://aihubmix.com/v1/chat/completions exatamente, sem espaço no final.

"Modelo não encontrado" ou um erro de modelo

• Por que: O campo Modelo contém um nome de exibição, tem uma letra maiúscula, ou perdeu seu sufixo -free.
• Correção: Copie o ID da lista de modelos gratuitos novamente e cole-o como está.

"Chave inválida" ou um erro de autenticação

• Por que: A chave pertence a outro serviço, foi excluída, tem um espaço extra, ou o campo está vazio. O AIHubMix retorna "nenhuma chave fornecida" para uma chave vazia e "chave inválida" para uma errada.
• Correção: Crie uma nova chave na página de chaves do AIHubMix e cole-a novamente.

Você mudou as configurações, mas nada mudou

• Por que: O JanitorAI ainda está usando a configuração que carregou antes.
• Correção: Atualize a página ou reinicie o chat, e verifique se a configuração correta está selecionada.

A "resposta" do bot é um aviso de que seu teste foi esgotado

• Por que: As 10 chamadas de teste se esgotaram. O AIHubMix continua respondendo com uma nota em vez de um erro, então no JanitorAI isso provavelmente aparece como uma mensagem no chat.
• Correção: Recarregue $1 ou mais uma vez; a conta muda para cotas diárias para modelos gratuitos. O guia de recarga nesta série cobre os passos.

Erro 429

Um 429 tem duas causas comuns:

• Você atingiu um limite. Após seu limite por minuto ou por dia, a API retorna 429 até que o próximo minuto ou dia comece. Alguns modelos têm limites mais baixos do que os 100 por dia e 10 por minuto padrão (por exemplo, qwen3.6-plus-preview-free permite 50 por dia e 5 por minuto), e o pool compartilhado de 1M tokens pode se esgotar primeiro em chats longos.
• O modelo está ocupado. A capacidade gratuita em alguns modelos é limitada, e o changelog do AIHubMix avisou que erros 429 "podem ocorrer" em um modelo gratuito por esse motivo. Quando muitas pessoas se acumulam em um modelo popular ao mesmo tempo, essa é a causa usual.

Correção: Espere um minuto e tente novamente, envie mensagens com menos frequência, ou mude para uma segunda configuração salva com um modelo diferente. Se o limite diário for o problema, a cota é redefinida uma vez por dia.

Um 404 que menciona model_retired

• Por que: O modelo foi removido. Desde 1 de setembro de 2026, modelos aposentados retornam um explícito model_retired 404.
• Correção: Escolha outro modelo da lista gratuita e atualize o campo Modelo.

Modelos gratuitos pararam de funcionar depois que você usou os pagos

• Por que: Quando o saldo de uma conta cai abaixo de -$1, modelos gratuitos não podem ser chamados até que a conta seja recarregada novamente.
• Correção: Recarregue para trazer o saldo de volta acima desse limite.

Ainda preso?

A página de contato do AIHubMix lista o servidor oficial do Discord, o e-mail de suporte (feedback@aihubmix.com) e a página de status. A página de status rastreia serviços como Chat Completions, não modelos individuais, então um modelo ocupado não aparecerá lá.

Para obter uma resposta rápida, inclua:

• o horário da solicitação e seu fuso horário
• o ID do modelo e o endpoint (a URL do Proxy)
• o status HTTP ou texto de erro, e um ID de rastreamento se um foi mostrado
• o que você esperava e o que aconteceu em vez disso

Deixe de fora sua chave da API. O suporte não precisa dela, e qualquer um que a tiver pode gastar sua cota.

FAQ

O AIHubMix é gratuito para usar no JanitorAI?
Toda nova conta recebe 10 chamadas de teste em todos os modelos gratuitos. Após um recarregamento único de $1 ou mais, os modelos gratuitos mudam para cotas diárias: 100 solicitações por dia, 10 por minuto e 1M tokens por dia compartilhados entre eles.

O que exatamente vai no campo URL do Proxy?
https://aihubmix.com/v1/chat/completions, o endereço completo. Se você colar apenas https://aihubmix.com/v1, clique no botão Adicionar /chat/completions uma vez para completá-lo.

Por que não vejo a opção de proxy para alguns bots?
Apenas bots marcados como "proxy permitido" funcionam com um proxy. Outros bots permanecem no modelo próprio do JanitorAI.

Qual ID de modelo devo começar?
Qualquer ID da lista de modelos gratuitos funciona se copiado exatamente. Muitos usuários do JanitorAI começam com xiaomi-mimo-v2.6-pro-free; o guia de modelos nesta série compara as alternativas.

Preciso atualizar após mudar o modelo?
Sim. Salve a configuração, depois atualize a página ou reinicie o chat para que o JanitorAI reconheça a mudança.

Por que continuo recebendo erros 429?
Ou você ultrapassou um limite por minuto ou por dia, ou o modelo está ocupado. Espere um minuto, diminua a frequência, ou mude para outra configuração salva com um modelo diferente.

Posso compartilhar minha chave da API com amigos?
Não. Os Termos de Serviço proíbem o compartilhamento de uma conta do AIHubMix, e qualquer um que usar sua chave gasta sua cota diária.

Continue lendo: a série AIHubMix para JanitorAI

• Sua configuração funciona, mas quantas mensagens ela realmente lhe dará por dia? A matemática dos tokens está aqui: Limites de Modelos Gratuitos do AIHubMix para JanitorAI: 10 Chamadas de Teste, o Desbloqueio de $1 e o Limite de Tokens
• Se o aviso de teste já apareceu em seu chat, este guia passa pelo desbloqueio das cotas diárias: Como Pagar no AIHubMix com Alipay
• Não tem certeza se o ID do modelo que você colou é o certo para interpretação de papéis? Compare as opções gratuitas: Qual Modelo Gratuito do AIHubMix Usar para Interpretação de Papéis no JanitorAI
• Antes do seu primeiro chat longo, veja como a retenção zero de dados impede que suas mensagens sejam armazenadas no AIHubMix: AIHubMix Suporta Chat de Interpretação de Papéis no JanitorAI, com Retenção Zero de Dados por Padrão

Fontes

• Modelos AI Gratuitos (AIHubMix)
• Início Rápido (Documentação do AIHubMix)
• Changelog (Documentação do AIHubMix)
• custom-proxy-for-janitorai (GitHub)
• Configurações de Geração do Janitor AI (2026) (Arcanum RPGs)