Configuração de proxy do Janitor AI: formato de URL, modelos e correções de 429

Resposta rápida: os três campos que o JanitorAI pede

A configuração de proxy do JanitorAI pede exatamente três valores: uma proxy URL, um model name e uma API key. A proxy URL precisa ser o endpoint completo de chat completions, não uma base URL. Se o seu provider te dá uma base URL terminando em /v1, adicione /chat/completions antes de colar no JanitorAI. Esse detalhe sozinho causa mais configurações falhadas do que tudo mais junto. Digite o ID do modelo exatamente como o provider escreve, minúsculo e com hífens incluídos, depois salve e envie uma mensagem de teste curta. Se voltar uma resposta, está pronto. Se voltar um código de erro, pule para a tabela de erros abaixo. Todo código comum tem uma causa específica e uma correção específica.

Proxy URL:  https://api.apisrouter.com/v1/chat/completions
Model:      deepseek-v4-flash
API Key:    sk-...   (cole exatamente, sem aspas, sem espaços no final)

O que "proxy" significa na comunidade do JanitorAI

A palavra é enganosa. No jargão do JanitorAI, um proxy não é um proxy de rede ou uma VPN. É qualquer endpoint de API compatível com OpenAI para o qual o site envia suas requisições de chat em vez do backend padrão. A comunidade adotou o termo anos atrás, quando as pessoas começaram a rotear chats por proxies reversos de APIs de providers, e o nome ficou mesmo com a maioria das configurações de hoje falando diretamente com um provider ou gateway. As pessoas rodam um proxy por três motivos. Primeiro, escolha de modelo: você escolhe exatamente qual LLM escreve seus personagens em vez de aceitar o que o site usa por padrão. Segundo, qualidade: modelos como DeepSeek V4 ou Claude escrevem cenas mais longas e coerentes que uma camada gratuita embutida. Terceiro, controle de custo: com uma chave paga por token você vê exatamente quanto cada chat custa, em vez de pagar por uma assinatura que talvez você não use por completo. Existem três tipos de endpoints que você vai ver compartilhados na comunidade. APIs oficiais de provider (OpenAI, Anthropic, xAI, DeepSeek) exigem uma conta com cada fornecedor. Gateways agregam muitos modelos atrás de uma única URL compatível com OpenAI e uma única chave. "Proxies gratuitos" da comunidade são chaves compartilhadas que outra pessoa paga, motivo pelo qual são instáveis e pesadamente limitados em taxa. Mais uma coisa que vale dizer com clareza: seja qual for o endpoint que você usar, a política de conteúdo do provider do modelo a montante continua se aplicando a toda resposta, e os próprios termos do JanitorAI, incluindo sua exigência de maioridade, continuam regendo a plataforma. Conhecer as duas políticas antes de escolher um modelo evita recusas no meio de uma cena.

Configuração completa: da chave de API à primeira resposta

Se você quer uma única chave que cubra DeepSeek, GLM, Kimi, Claude, Gemini e Grok de uma vez, um gateway compatível com OpenAI como a APIsRouter é a rota de baixo atrito: o checkout em /topup não exige cadastro de conta, a chave chega por email, e a proxy URL para o JanitorAI é https://api.apisrouter.com/v1/chat/completions. Uma nuance se você também usa o SillyTavern: o SillyTavern quer a base URL terminando em /v1 e preenche a lista de modelos automaticamente a partir de /v1/models com sua chave, enquanto o JanitorAI quer o caminho completo incluindo /chat/completions. Mesmo endpoint, quantidade diferente da URL. Misturar os dois formatos é a principal causa de erros 404 nos dois apps.

• Consiga uma chave de API de um provider ou gateway compatível com OpenAI. Você precisa da string da chave e da URL do endpoint documentado.
• Abra qualquer chat de personagem no JanitorAI, depois abra API Settings e selecione a opção Proxy.
• Cole a URL completa do endpoint terminando em /chat/completions no campo de proxy URL.
• Digite o ID do modelo exatamente como documentado, por exemplo deepseek-v4-flash ou glm-5.
• Cole a chave de API, salve as configurações, e atualize a página se o salvamento não registrar.
• Envie uma mensagem de teste de uma linha. Uma resposta normal significa que toda a cadeia funciona.

Teste o endpoint com curl antes de culpar o JanitorAI

Quando um proxy se comporta mal, teste o endpoint fora do JanitorAI primeiro. Uma chamada curl de 10 segundos diz se o problema é o endpoint, a chave, ou o jeito que você configurou o site. Rode isso em qualquer terminal, com sua própria chave e modelo:

curl https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Reply with one short sentence."}]
  }'

Erro 429: por que proxies gratuitos limitam a taxa no pico

Uma resposta 429 significa "requisições demais". É de longe o erro de proxy mais reportado na comunidade do JanitorAI, e o padrão por trás dele é previsível. Um proxy gratuito ou compartilhado é uma única chave de API servindo centenas ou milhares de usuários. Providers aplicam limites por chave em requisições por minuto e tokens por minuto, então quando o tráfego de horário de pico dos EUA chega, todo mundo passa pela mesma cota e a chave começa a rejeitar requisições. Você não está sendo escolhido a dedo. O balde simplesmente está vazio, e ele reabastece mais devagar exatamente quando mais gente quer conversar. Proxies gratuitos têm um segundo modo de falha: a própria chave morre. Chaves compartilhadas são revogadas por violação de política ou saldo esgotado, e nesse ponto a mesma URL começa a devolver 401 ou 404, muitas vezes sem aviso nenhum. Endpoints pagos evitam a parede do horário de pico estruturalmente. Sua chave tem sua própria cota em vez de dividir um balde com uma multidão, o faturamento é por token então o provider não tem motivo para te empurrar para um tier de assinatura, e a capacidade é provisionada para tráfego pagante. Se você ver um 429 em uma chave paga pessoal, quase sempre é um limite de rajada curto: espere alguns segundos e tente de novo, ou desacelere as regenerações em disparo rápido. 429s persistentes em uma chave pessoal merecem um ticket de suporte, não uma solução alternativa.

Tabela de erros de proxy do JanitorAI: 429, 401, 404, timeout

Compare o código que o JanitorAI mostra com esta tabela. A coluna de correção assume que você já confirmou que o endpoint funciona com o teste curl acima; se o curl falhar da mesma forma, o problema está do lado do endpoint, não no JanitorAI.

Qual modelo rodar atrás do seu proxy do Janitor AI

A escolha de modelo importa mais do que qualquer ajuste nas configurações de geração. O consenso da comunidade é estável: a família DeepSeek V4 é a favorita para roleplay porque escreve respostas longas e dentro do personagem a preços onde o custo deixa de ser uma consideração. GLM-5, Kimi K2.6 e MiMo são as opções de valor que vale revezar quando você quer uma voz diferente. O Grok 4.5 entra na lista das opções de política flexível porque a política publicada da xAI permite temas maduros em cenários claramente ficcionais para usuários adultos. O Claude Sonnet 4.6 escreve a prosa mais forte do catálogo e serve para escrita criativa SFW; a política da Anthropic proíbe conteúdo explícito, então mantenha ele em chats voltados a história, não explícitos. Todos os preços de catálogo abaixo são pague conforme o uso, sem assinatura. Modelos globais têm preço 20% abaixo das taxas oficiais e modelos chineses abaixo do preço oficial, e um primeiro depósito dobra seu saldo inicial.

Perguntas frequentes