Como usar o OpenRouter no Janitor AI: Configuração do proxy

Como a conexão funciona

O Janitor AI é um site de bate-papo com personagens. Além de suas opções internas, ele permite integrar seu próprio modelo por meio de uma configuração de API. Essa configuração pede três coisas: uma URL de endpoint, uma chave e um nome do modelo. O OpenRouter se encaixa porque expõe um endpoint compatível com OpenAI; seus nomes de modelo têm a forma vendor/model e sua chave vem da sua conta OpenRouter.

Os mesmos três campos funcionam com qualquer outro serviço compatível com OpenAI. A API deste site é um exemplo: URL base https://api.openrouternsfw.com/v1, uma chave bearer e o ID do modelo uncensored. Portanto, os passos abaixo cobrem ambos os casos. Quando um passo difere entre os dois, eu digo isso.

O Janitor AI é um site de terceiros e seus menus mudam. Descrevo as configurações conforme são comumente dispostas, então espere que os rótulos diferem um pouco. Os valores são o que importa.

Prepare os três valores

Antes de abrir o Janitor AI, colete estes.

Campo	OpenRouter	Esta API
Endpoint	URL estilo OpenAI da OpenRouter, conforme sua documentação	https://api.openrouternsfw.com/v1/chat/completions
Chave	Chave da sua conta OpenRouter	Chave da página de chave de API
Nome do modelo	Um ID vendor/model da lista deles	uncensored

Para esta API, a página da chave também permite que novos usuários resgatem $0,50 de crédito de teste grátis com um clique, um por pessoa, válido por 7 dias. O cadastro é feito com Google ou com e-mail e senha. O crédito de teste grátis é suficiente para testar toda a configuração antes de você adicionar crédito.

Teste o endpoint com curl primeiro

O Janitor AI oferece pouco feedback quando um proxy falha; você geralmente vê um erro genérico no chat. Verifique o endpoint fora do site, para saber se os valores estão corretos antes de colá-los.

Copycurl https://api.openrouternsfw.com/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship mechanic."},
      {"role": "user", "content": "Mara, the engine is making that noise again."}
    ],
    "max_tokens": 200
  }'

Uma resposta JSON com uma matriz choices significa que a chave, a URL e o nome do modelo estão todos corretos. Consulte os cabeçalhos de resposta se quiser mais: X-Balance-USD mostra o crédito restante, e X-Request-Id é útil se você entrar em contato com o suporte.

Insira o proxy no Janitor AI

1. Abra um chat com qualquer personagem.
2. Abra o menu no chat e escolha as configurações de API ou geração. O nome exato varia conforme a versão.
3. Selecione a opção de proxy, que é a de um endpoint personalizado compatível com OpenAI, em vez do modelo interno.
4. Cole a URL do endpoint no campo de URL do proxy.
5. Cole a chave no campo de chave.
6. Digite o nome do modelo exatamente como fornecido: uncensored para esta API.
7. Salve as configurações e recarregue a página do chat.

Qual forma de URL usar é o único ponto em que as pessoas se atrapalham. O campo proxy do Janitor AI normalmente espera a URL completa de completions de chat, terminando em /chat/completions. Outras ferramentas esperam apenas a URL base, terminando em /v1, e adicionam o caminho elas mesmas. Se a URL completa gerar um erro, tente a URL base, e vice-versa. O teste curl acima mostra que a URL completa em si é válida, então uma falha indica como o site constrói sua requisição, não a chave.

Os nomes dos modelos são sensíveis a maiúsculas e minúsculas e devem corresponder. Um nome de modelo errado é a segunda causa mais comum de falha na primeira mensagem.

Configurações importantes para roleplay

O Janitor AI expõe algumas configurações de geração ao lado dos campos de proxy. A API encaminha os parâmetros de amostragem, então eles têm efeito.

• Temperatura: 0,7 a 1,0 mantém o diálogo animado. Valores mais altos começam a desviar e inventar detalhes que contradizem o cartão do personagem.
• Máximo de tokens: controla o tamanho da resposta. Um valor entre 300 e 600 é adequado para chat. A conclusão pode usar o restante da janela de 100.000 tokens, mas respostas de chat tão longas raramente são o que você deseja.
• Tamanho do contexto: a API aceita até 100.000 tokens, prompt mais resposta. Um valor menor, como 8.000, mantém o custo por mensagem baixo e ainda mantém muito histórico. Aumente apenas se o personagem esquecer coisas que você precisa.
• Controle de repetição: se um personagem repete as mesmas frases, uma penalidade de frequência ou presença modesta ajuda. Ambas são passadas.

O modelo é ajustado para responder sem recusas de conteúdo para uso adulto legal, então uma ficha (character card) escrita para uma história adulta não deve acionar texto de recusa. Uma regra é fixa: conteúdo sexual envolvendo menores de idade não é permitido, e você não deve escrever texto de ficha que o sugira.

Quanto custa

Os preços são $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. No roleplay, quase todo o custo é de entrada, porque cada mensagem reenvia o cartão do personagem e o histórico do chat.

Tome uma mensagem com 8,000 tokens de contexto e uma resposta de 300 tokens:

• Entrada: 8.000 x $0,15 / 1M = $0,0012
• Saída: 300 x $0,50 / 1M = $0,00015
• Total: $0,00135 por mensagem, ou $1,35 por 1.000 mensagens

Uma recarga de $20 paga por cerca de 14.800 mensagens nesse tamanho ($20 / $0,00135 é 14.814). O crédito de teste de $0,50 cobre cerca de 370. Se você aumentar o contexto para 30.000 tokens, a entrada sozinha sobe para $0,0045 e uma mensagem custa $0,00465 com a mesma resposta, então use contextos grandes apenas quando precisar.

Recargas variam de $20 a $500 com bônus de 5% a partir de $50, 10% a partir de $100 e 15% a partir de $200. O pagamento é em cripto (USDT no TRC20 ou USDC na Base), o crédito nunca expira e requisições falhas ou recusadas não são cobradas. Os detalhes estão na página de preços.

Solução de Problemas

Erro de rede ou sem resposta

Verifique a forma da URL (caminho completo ou base). Verifique se não há espaço no final no campo da chave. Depois execute o teste curl novamente na sua máquina.

HTTP 401

A chave está errada ou foi colada com caracteres extras. Gere-a novamente na página de chave.

HTTP 429

Leia o código de erro. rate_limited significa mais do que as requisições permitidas por minuto (300 para uma chave completa, 60 para uma chave de teste). concurrency significa muitos ao mesmo tempo (8 para uma chave completa, 2 para uma chave de teste); no Janitor AI isso acontece quando você regenera uma resposta enquanto a anterior ainda está em streaming, porque uma solicitação em streaming mantém seu slot até o fim. Um 429 com Retry-After: 5 significa sobrecarga temporária, então aguarde cinco segundos e tente novamente.

Respostas são truncadas ou divagam

Ajuste max tokens e temperatura. Se o personagem esquecer eventos recentes, aumente um pouco o tamanho do contexto.

Saldo esgotado

O cabeçalho X-Balance-USD mostra o que resta. Adicione crédito no painel; os docs cobrem o formato de erro em detalhes.

OpenRouter ou esta API para o Janitor AI

São tipos diferentes de serviço. O OpenRouter é um roteador que oferece muitos modelos de muitos provedores; você escolhe o modelo por nome, e o que cada modelo escreverá ou não depende desse modelo. Verifique sua lista atual de modelos e preços em seu próprio site. Esta API oferece um único modelo de texto de pesos abertos, executado por um provedor independente e ajustado para responder sem recusas de conteúdo para uso adulto legal. Não é uma API oficial de nenhum fabricante de modelo.

Se você quer variedade, mantenha sua configuração do OpenRouter. Se seus personagens encontrarem recusas e você quiser um modelo único, estável e barato, este é simples de tentar: cadastre-se, reivindique o crédito de teste e cole os três valores acima. Os prompts não são usados para treinamento.

Mais guias

• Alternativa gratuita ao OpenRouter? O que você realmente recebe
• Bot do Discord de Código Aberto com um LLM sem censura
• API Hermes: Como usar LLMs sem censura no seu projeto