Um proxy no Janitor AI geralmente não é uma VPN nem uma ferramenta para ocultar IP. Na prática, ele é a rota até uma API de LLM — e só funciona quando endpoint, ID exato do modelo e chave de API pertencem ao mesmo provedor. Ao usar um proxy reverso, você ainda adiciona um servidor e uma nova relação de confiança à cadeia.
Defina a rota antes de abrir o Janitor AI
Para a maioria das pessoas, a opção mais simples é conectar o Janitor AI diretamente a um endpoint de API compatível com OpenAI. Um agregador como o OpenRouter é útil para quem quer acessar vários modelos com uma única conta. Já um proxy reverso faz sentido quando você controla o relay ou precisa adaptar um backend privado ou local.
| Rota | Caminho da requisição | Quem processa a requisição? | Esforço de configuração | É uma boa opção para começar? |
|---|---|---|---|---|
| API direta | Janitor AI → provedor ou gateway | O operador do endpoint e seu provedor de modelo upstream | Baixo | Sim, para uma API externa convencional |
| Agregador | Janitor AI → agregador de modelos → modelo escolhido | O agregador e seu provedor upstream | Baixo a médio | Sim, quando você precisa escolher modelos |
| Proxy reverso | Janitor AI → seu relay → provedor ou modelo local | Você, o host do relay e o provedor upstream | Médio a alto | Apenas se você controlar o relay |
Não confunda um “proxy grátis” compartilhado com uma conexão direta à API. Um relay compartilhado pode ler o tráfego enviado por ele, desaparecer sem aviso ou pedir credenciais que jamais deveria receber. Usar a chave de um provedor no endpoint do próprio provedor é uma situação completamente diferente.
O que cada campo de proxy do Janitor AI significa
Ao preencher o formulário de Proxy do Janitor AI, confira três dados específicos da rota: URL do endpoint, ID exato do modelo e chave de API. Os três precisam vir do mesmo provedor ou relay.
| Campo do Janitor AI | O que preencher | Erro mais comum |
|---|---|---|
| Nome da configuração | Qualquer rótulo, como AIReiter GPT-5.6 Luna | Alterar esse rótulo não troca o modelo usado |
| Nome do modelo | O ID atual e exato do modelo no provedor | Nome de exibição, mudança de maiúsculas/minúsculas ou sufixo :free desatualizado podem causar erro de modelo |
| URL de outra API/proxy | O formato de endpoint exigido pela rota | Uma URL base pode ser aceita por um SDK, mas não pelo campo de proxy do Janitor AI |
| Chave de API | Uma chave criada para aquele mesmo endpoint ou relay | Chave de outro provedor, chave revogada ou chave com espaço extra não funcionam |
A URL final da requisição nem sempre equivale à URL base usada por um SDK. Um SDK compatível com OpenAI normalmente usa uma base como https://example.com/api/v1 e acrescenta /chat/completions por conta própria. Já o campo de proxy do Janitor AI pode exigir a URL completa, https://example.com/api/v1/chat/completions. Siga, portanto, as instruções do endpoint para o cliente que você está usando.
O Janitor AI também oferece uma permissão de proxy por personagem. Em um anúncio oficial de um moderador, o Janitor AI explicou que selecionar Permitir proxy deixa outras pessoas usarem um bot com proxies, pois o proxy recebe as informações do bot. Um personagem limitado às opções OpenAI e JanitorAI não pode ser usado por meio de um proxy externo. Essa permissão é independente da validade da sua chave de API.
Configure o Janitor AI em cinco minutos
Crie uma configuração, salve, atualize a página e faça um teste com um prompt curto. Esse processo ajuda a separar rapidamente erros de endpoint, ID do modelo e chave.
1. Crie uma chave no provedor
Crie uma chave de API no provedor ou gateway cuja URL será inserida no Janitor AI. Copie-a quando o serviço a exibir, guarde-a como um segredo e não a publique em capturas de tela, mensagens no Discord, extensões de navegador ou formulários de proxy compartilhados.
Um modelo marcado como gratuito ainda pode exigir uma chave do provedor. “Gratuito” normalmente descreve o preço atual ou a cota disponível naquele provedor; isso não significa que o Janitor AI possa chamar o modelo sem autenticação.
2. Abra o painel de Proxy
Abra o chat de um personagem no Janitor AI e encontre Configurações de API. Escolha Proxy e depois Adicionar configuração, ou o controle equivalente. Para orientações atualizadas do produto, consulte a categoria oficial da Central de Ajuda do Janitor AI sobre conta e configuração, pois os rótulos e a localização dos itens podem mudar.
Usuários relataram alterações nos campos e a exigência de preencher o modelo na interface de proxy do Janitor AI. (Exemplo de relato de usuário)
3. Preencha, salve, atualize e teste
Insira apenas dados fornecidos por uma mesma rota. Não misture um endpoint de um serviço, um ID de modelo copiado de outro e uma chave de uma terceira conta.
- Dê à configuração um nome fácil de reconhecer.
- Cole o ID exato do modelo na página ou lista atual de modelos do provedor.
- Cole o endpoint completo exigido pelo campo de proxy do Janitor AI.
- Cole a chave de API correspondente.
- Salve a configuração.
- Atualize ou reabra a aba do Janitor AI e envie uma mensagem curta de teste.
Se o personagem não estiver habilitado para proxy, troque para um personagem que permita proxies antes de investigar o endpoint. Uma configuração válida no provedor não consegue ignorar a restrição definida pelo criador.
Configuração da AIReiter: rota compatível com OpenAI verificada
Na rota da AIReiter, insira a URL final de Chat Completions no campo Proxy URL do Janitor AI, e não a URL base mais curta usada por SDKs. O guia de integração GPT-5.6 da AIReiter informa Chat Completions em /api/v1/chat/completions, usa gpt-5.6-luna como modelo de exemplo e distingue a URL base do cliente do caminho que o próprio cliente acrescenta.
Use esta configuração como ponto de partida:
| Campo do Janitor AI | Valor da AIReiter |
|---|---|
| Nome da configuração | AIReiter GPT-5.6 Luna |
| Nome do modelo | gpt-5.6-luna |
| URL de outra API/proxy | https://aireiter.com/api/v1/chat/completions |
| Chave de API | Sua chave de API da AIReiter |
A diferença entre os endpoints é esta:
- URL de Proxy do Janitor AI:
https://aireiter.com/api/v1/chat/completions - URL base de SDK compatível com OpenAI:
https://aireiter.com/api/v1 - Verificação da lista de modelos:
https://aireiter.com/api/v1/models
Não cole /api/v1/models no Janitor AI: essa é uma rota de diagnóstico para verificar se o ID do modelo está disponível. O guia da AIReiter mostra este padrão de autoverificação:
curl -sS "https://aireiter.com/api/v1/models" \
-H "Authorization: Bearer $AIREITER_API_KEY"
Se a resposta não contiver gpt-5.6-luna, use o ID exato retornado pela lista e atualize a configuração no Janitor AI. Ao testar um problema de ID de modelo, mantenha o endpoint e a chave inalterados.
A AIReiter usa cobrança por uso, e não uma categoria de plano. Por isso, a chave de API ainda precisa estar vinculada a uma conta com saldo utilizável. Consulte a página de preços atual da AIReiter antes de contar com uma tarifa exibida: o custo de um chat depende dos tokens de entrada e saída, não apenas da quantidade de mensagens.
OpenRouter e outros provedores: adapte o mesmo formulário
O formulário do Janitor AI continua igual ao trocar de provedor, mas endpoint, chave e ID do modelo devem mudar em conjunto. O quickstart oficial do OpenRouter documenta sua API compatível com OpenAI, e o catálogo atual de modelos é onde você deve copiar um ID de modelo ativo.
| Campo | Padrão do OpenRouter |
|---|---|
| Nome do modelo | Copie o ID atual e exato do catálogo de modelos do OpenRouter |
| URL de outra API/proxy | https://openrouter.ai/api/v1/chat/completions |
| Chave de API | Uma chave criada na sua conta do OpenRouter |
Considere um sufixo de modelo como :free uma indicação de disponibilidade atual, não um dado permanente de configuração. Modelos gratuitos podem ser removidos, sofrer limite de taxa ou ser renomeados; copie o ID atual imediatamente antes de salvar a configuração no Janitor AI.
Uma thread oficial de moderador do Janitor AI aponta para materiais de início rápido e solução de problemas do proxy/OpenRouter do Janitor, ao mesmo tempo que separa problemas de integração do Janitor do suporte de cobrança e conta do provedor. Em uma conexão direta com outro provedor, substitua os três dados específicos da rota pelo endpoint, pela chave e pelo ID de modelo desse próprio provedor.
Proxy reverso ou API direta: a escolha de segurança
A rota direta tem menos partes envolvidas: o provedor ou gateway administra autenticação, limites, cobrança, registros e sua política de privacidade. Um proxy reverso adiciona um relay que pode inspecionar, transformar, registrar ou rejeitar o tráfego antes que ele chegue ao modelo upstream.
Use um proxy reverso apenas se houver um motivo para operá-lo, como conectar um backend privado por um relay HTTPS autenticado ou normalizar o protocolo de um provedor. Uma URL privada em localhost funciona somente se o componente que faz a requisição estiver na mesma máquina. Se a requisição parte do servidor do Janitor AI, ele não consegue acessar o localhost do seu computador. Quando essa arquitetura for necessária, use um relay HTTPS público devidamente autenticado.
Se você controla o relay, siga esta lista:
- Exija HTTPS e um token de autenticação separado para o relay.
- Guarde a chave do provedor upstream no relay, em vez de inseri-la em um serviço compartilhado desconhecido.
- Desative o registro detalhado do corpo das requisições ou defina um período de retenção curto e documentado.
- Restrinja os hosts upstream e métodos de requisição permitidos.
- Verifique se o relay encaminha cabeçalhos, histórico da conversa e dados do personagem.
- Revogue e substitua credenciais após qualquer suspeita de exposição.
Um alerta de usuário real mostra por que relays anônimos merecem cautela:
“se você usa o proxy moxxie no janitor ai, por favor pare de usá-lo!! quem usou esse proxy teve seus chats vazados, assim como seu endereço IP...” — @Ash3rz_c0m, alerta de usuário no X, junho de 2023 (fonte)
Trata-se de um incidente relatado por usuário, não de uma prova de que todo proxy reverso seja malicioso. Não forneça uma chave real de provedor nem conversas privadas a um relay cujo operador, política de retenção e histórico de incidentes você não consiga verificar.
Diagnostique falhas pelo ponto da rota onde ocorreram
A maioria dos erros de proxy no Janitor AI fica mais fácil de isolar ao testar a rota por camadas. Primeiro, verifique se o modelo integrado do Janitor AI responde. Depois, confira os dados da configuração um de cada vez antes de investigar cotas ou indisponibilidades do provedor.
| Sintoma ou status | Camada provável | Primeira verificação |
|---|---|---|
400 ou “modelo inválido” | Requisição ou seleção de modelo | Copie o ID atual e exato do modelo; confira maiúsculas/minúsculas, prefixo do provedor e sufixos |
401 Unauthorized | Autenticação | Revogue uma chave suspeita, crie outra, remova espaços e confirme que ela pertence ao provedor do endpoint |
402 ou mensagem de pagamento/cota | Saldo ou permissão da conta | Confira créditos, situação de cobrança e a franquia gratuita atual do provedor |
404 ou “modelo não encontrado” | URL ou rota do modelo | Compare o caminho completo do endpoint e o ID do modelo com a documentação atual do provedor |
429 | Limite de taxa ou uso | Aguarde, reduza a frequência das requisições, troque para um modelo disponível ou adicione saldo quando apropriado |
500, 502, 503 ou timeout | Disponibilidade do upstream ou relay | Tente novamente mais tarde, confira o status do provedor e, se possível, teste sem relay personalizado |
| “Falha ao buscar” ou erro de rede | Navegador, endpoint, CORS ou relay inacessível | Revise HTTPS, a URL completa e se o relay está acessível publicamente |
O significado dos códigos de status varia conforme o provedor, então dê prioridade ao conteúdo da resposta. Um erro de nome de modelo não se resolve gerando outra chave, e uma chave revogada não se corrige alterando a temperatura.
Relatos da comunidade mostram por que IDs de modelo exigem uma verificação de atualização. Em uma thread para iniciantes do Janitor AI, u/Puzzleheaded-Town350 publicou:
“Recebo esta mensagem: ‘proxy error 400 open-mistral-nemo-2407 is not a valid model’” — u/Puzzleheaded-Town350 em r/JanitorAI_Official
Siga esta ordem quando uma nova configuração falhar:
- Teste o modelo integrado do Janitor AI para separar um problema da plataforma de um problema no proxy.
- Confirme que o personagem permite proxies.
- Confirme a URL final do endpoint, incluindo
/chat/completionsquando a rota exigir esse caminho. - Confirme o ID exato do modelo na lista atual do provedor.
- Confirme que a chave corresponde ao endpoint e ainda tem permissão ou saldo.
- Tente novamente com as configurações padrão de geração antes de ajustar temperatura ou limites de tokens.
Privacidade e higiene da conta
O endpoint pode receber prompts, histórico de conversas, dados de seleção de modelo e, às vezes, informações do personagem. Revise os termos de privacidade e as configurações de retenção do provedor direto, agregador ou relay escolhido.
Se uma chave puder ter sido exposta, revogue-a, crie outra, remova o valor antigo das configurações do Janitor AI e confira o histórico de uso. Não teste uma chave vazada continuando a utilizá-la.
Perguntas frequentes sobre proxy no Janitor AI
Um proxy do Janitor AI é uma VPN?
Não. Ele encaminha requisições de chat para um LLM externo; uma VPN altera o roteamento de rede e não fornece um modelo de linguagem.
Preciso de uma chave de API para um modelo gratuito?
Em geral, sim. Um provedor pode não cobrar por um modelo ou por determinada cota, mas ainda exigir uma chave vinculada à conta.
Devo inserir a URL completa ou apenas /api/v1?
Use a URL final esperada pelo campo Proxy do Janitor AI. No exemplo da AIReiter, ela é https://aireiter.com/api/v1/chat/completions; /api/v1 é a URL base do SDK.
Por que um personagem se recusa a funcionar com proxy?
O criador do personagem pode ter desativado o uso de proxy. Uma chave externa válida não consegue substituir essa configuração.
O Janitor AI pode chamar localhost diretamente?
Apenas se o componente que faz a requisição estiver na mesma máquina do servidor local. Caso contrário, use um relay HTTPS público com segurança adequada, em vez de expor um serviço local sem autenticação.
Por que um ID de modelo que funcionava parou de funcionar?
Provedores alteram disponibilidade de modelos, aliases, cotas e rótulos de planos gratuitos. Consulte novamente a lista de modelos ativa e atualize primeiro o campo do modelo.
Um proxy gratuito compartilhado é seguro?
Não presuma que seja. O operador pode conseguir ler requisições ou capturar credenciais; prefira uma rota direta ao provedor ou um proxy reverso que você opere e consiga auditar.
Comece com uma chave privada, um ID exato de modelo e um endpoint completo. A configuração por API direta vence em simplicidade; um proxy reverso só justifica sua manutenção quando você precisa controlar o relay ou a conexão upstream.