Chave de API do Janitor AI: Como configurar via proxy
Para usar a chave de API do Janitor AI de outro serviço, o Janitor AI precisa de três dados: endereço do endpoint, chave de API e nome do modelo. Veja abaixo a ordem de configuração e correção dos erros mais comuns.

Atualizado

Pontos principais
Três campos: endereço do endpoint, chave de API e nome do modelo uncensored.
Teste a chave primeiro com curl para saber se o problema está na chave ou na configuração do Janitor AI.
O erro 404 geralmente indica endereço errado, 401 indica chave errada, 429 indica muitas requisições.
Um contexto maior torna cada mensagem mais cara, então limite conforme necessário.
Resumo: três valores a serem preenchidos
A Janitor AI oferece opções para conectar seus próprios provedores de modelo por meio de um endpoint compatível com OpenAI. Portanto, para obter a chave de API da Janitor AI, você só precisa preencher três valores:
- Endereço do endpoint:
https://api.apitanpasensor.com/v1/chat/completions - Chave de API: sua chave da página chave de API
- Nome do modelo:
uncensored
Os nomes das colunas e a localização do menu no Janitor AI podem mudar, então este artigo explica a configuração de forma geral. Se a interface for diferente da que você vê, siga o guia oficial do Janitor AI para essa seção e volte aos três valores acima.
Passo 1: obter a chave e testar com curl
Antes de mexer no Janitor AI, certifique-se de que sua chave funciona. Assim, se houver erro, você saberá que não é problema da chave. Novos usuários podem reivindicar $0,50 de crédito de teste na página da chave de API sem cartão, suficiente para algumas centenas de mensagens de teste.
curl https://api.apitanpasensor.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "Kamu adalah karakter fiksi bernama Laras, seorang penjaga mercusuar."},
{"role": "user", "content": "Selamat malam, boleh saya masuk?"}
],
"max_tokens": 200
}'
Se você receber um JSON com a resposta em choices[0].message.content, a chave e o modelo estão corretos. Verifique também o cabeçalho X-Balance-USD para ver o saldo restante.
Passo 2: preencher configurações de proxy no Janitor AI
No Janitor AI, as configurações do modelo geralmente estão no menu de configurações de API na tela de chat. Procure a opção para usar proxy ou fonte de modelo personalizada e preencha assim:
- Selecione a opção de proxy ou API personalizada, não o modelo padrão.
- Preencha o endereço do proxy com
https://api.apitanpasensor.com/v1/chat/completions. Muitos guias da comunidade indicam que este campo precisa do endereço completo até a parte chat completions. Se a conexão falhar, tente com e sem essa parte final. - Cole sua chave de API no campo de chave.
- Preencha o nome do modelo com
uncensored. As letras devem ser exatamente iguais. - Salve as configurações, recarregue a página e envie uma mensagem de teste.
Não coloque a palavra "Bearer" no campo de chave. Aplicativos compatíveis com OpenAI adicionam isso automaticamente; adicioná-lo duas vezes gera erro de autenticação.
Se tiver dúvidas sobre um passo, consulte a documentação do Janitor AI. As configurações lá são a referência mais recente para a interface. Para o lado da API, a referência está na nossa documentação.
Erros comuns e como corrigi-los
| Sintoma | Causa mais provável | Correção |
|---|---|---|
| Erro 401 ou falha na autenticação | Chave errada, cortada ou com espaços no início ou no final | Copie a chave novamente, certifique-se de que não contém a palavra "Bearer" e teste novamente com curl |
| Erro 404 | Endereço do endpoint errado, por exemplo, erro de digitação ou falta a parte /v1 | Use o endereço exatamente como acima e tente variações com ou sem /chat/completions |
| Erro no modelo | Os nomes dos modelos não são iguais | Digite uncensored em letras minúsculas |
Erro 429 com código concurrency | Muitas requisições simultâneas | Feche outras abas de chat que ainda estão gerando respostas |
Erro 429 com código rate_limited | Limite de requisições por minuto excedido | Aguarde um momento e tente novamente |
| Resposta interrompida ou falha total | Saldo esgotado ou contexto muito grande | Verifique o saldo pelo cabeçalho X-Balance-USD ou GET /v1/balance e reduza o tamanho do contexto |
Para chaves de teste, o limite é de 2 requisições simultâneas e 60 por minuto. Para chaves completas, 8 simultâneas e 300 por minuto. Quando a API está ocupada, ela também pode retornar 429 com o cabeçalho Retry-After: 5, indicando para tentar novamente em cinco segundos. Uma resposta em streaming ainda ocupa um slot até o fim.
Se todas as etapas estiverem corretas mas ainda falhar, envie o ID da requisição do cabeçalho X-Request-Id para o suporte para acelerar a investigação.
Se a resposta estiver lenta ou interrompida
Alguns problemas não são causados pela chave, mas sim pelo fluxo do chat. Verifique os seguintes itens em ordem:
- Várias abas ativas: cada resposta em streaming ocupa um slot de requisições simultâneas. Com a chave de teste, há apenas 2 slots, então três abas ao mesmo tempo facilmente acionam o erro 429.
- Resposta muito longa: respostas longas realmente levam mais tempo. Limite o tamanho da resposta nas configurações do Janitor AI.
- Contexto muito grande: prompts muito longos tornam a resposta inicial mais lenta e a cobrança maior.
- Sua rede: tente executar curl no mesmo computador. Se o curl funcionar mas o Janitor AI não, o problema está nas configurações do lado do Janitor AI, não na API.
Se tentar novamente e tiver sucesso, geralmente é sintoma de limite ou congestionamento temporário. Aguarde alguns segundos e reenvie a mensagem, não pressione o botão enviar várias vezes, pois cada tentativa ocupa um slot.
Configurando contexto e custo por mensagem
Sempre que você envia uma mensagem, o Janitor AI envia parte do histórico de chat para a API. Quanto maior o contexto que você permite, mais tokens de entrada são cobrados. A janela de contexto máxima aqui é de 100.000 tokens (prompt mais resposta), mas quase nenhum chat precisa disso.
Exemplo de cálculo com tarifa de $0,15 por 1 milhão de tokens de entrada e $0,50 por 1 milhão de tokens de saída:
- Contexto de 8.000 tokens e resposta de 400 tokens: 8.000 x 0,15 / 1.000.000 = $0,0012, mais 400 x 0,50 / 1.000.000 = $0,0002. Total de $0,0014 por mensagem.
- Cem mensagens assim: 100 x $0,0014 = $0,14.
- Com contexto de 2.000 tokens e a mesma resposta, o custo é $0,0003 + $0,0002 = $0,0005 por mensagem, ou $0,05 para cem mensagens.
Para personagens com histórico longo, um tamanho de contexto médio (alguns milhares de tokens) geralmente é suficiente. Aumente apenas quando o personagem começar a esquecer detalhes importantes. Uma discussão mais completa sobre custos está na página preços.
Configurações de geração úteis
A API passa os parâmetros de amostragem padrão, então as configurações no Janitor AI chegam ao modelo: temperature, top_p, stop, seed e penalidade de repetição. Algumas dicas iniciais:
- Temperatura: comece com um valor médio. Aumente um pouco se a resposta parecer rígida, diminua se o personagem começar a divagar.
- Penalidade de repetição: aumente um pouco se o modelo repetir a mesma frase em cada resposta.
- Comprimento da resposta: limite com max_tokens se a resposta for muito longa. Essa configuração também ajuda nos custos, pois tokens de saída são mais caros.
- Seed: é útil se você quiser repetir o mesmo resultado ao testar prompts de personagem.
Altere uma configuração por vez e compare várias respostas. Alterar três coisas ao mesmo tempo faz você não saber qual teve efeito.
Escrevendo fichas de personagem econômicas em tokens
Descrição do personagem, exemplos de diálogo e mensagem inicial são reenviados em quase todas as mensagens, então o comprimento afeta diretamente o custo. Um personagem com descrição de 3.000 tokens adiciona 3.000 x 0,15 / 1.000.000 = $0,00045 a cada mensagem. Para mil mensagens, isso é $0,45, um valor pequeno, mas você pode economizar escrevendo de forma mais concisa.
- Escreva fatos que realmente são usados na história: nome, personalidade, relacionamentos e regras do mundo. Remova parágrafos de fundo que nunca aparecem.
- Use frases curtas e concretas. O modelo entende melhor "Laras é silencioso, sabe o nome do navio, tem medo de tempestades" do que três parágrafos de metáforas.
- Forneça um ou dois exemplos de diálogo que mostrem o estilo de fala, não dez.
- Defina os limites da história no início, como gênero e ponto de vista, para que o modelo não se desvie.
Uma maneira simples de testar: crie uma versão curta e uma longa do mesmo personagem, envie cinco mensagens iguais para ambos e compare as respostas e os valores de usage. Muitas vezes a versão curta é tão boa quanto.
Conteúdo e limites aplicáveis
Os modelos aqui estão configurados para responder sem rejeição de conteúdo para uso adulto legítimo, como ficção, roleplay e aplicativos de companhia para adultos. No entanto, há um limite rígido: conteúdo sexual envolvendo menores de idade é proibido sem exceção, independentemente do enquadramento da história.
Este serviço é apenas para texto. Se a ficha do personagem no Janitor AI usar imagens, essas imagens não são geradas por esta API. Quanto aos dados, seu prompt não é usado para treinar o modelo, conforme explicado na página privacidade.
Outras diretrizes
Perguntas frequentes
Preciso de cartão para testar?
Não. Usuários novos podem reivindicar um crédito de teste de $0,50 com um clique na página da chave de API, sem cartão. O crédito é válido por 7 dias.
Qual nome de modelo devo inserir no Janitor AI?
Preencha uncensored, exatamente assim. Há apenas um modelo, então não há outras opções na lista.
Por que aparece o erro 404 depois de preencher o endereço?
Geralmente o endereço está incorreto. Use https://api.apitanpasensor.com/v1/chat/completions, ou tente sem a parte chat/completions se o Janitor AI adicioná-la automaticamente.
O que significa o erro 429?
Você excedeu o limite. O código concurrency significa muitas requisições simultâneas, rate_limited significa muitas por minuto. Aguarde um pouco e tente novamente.
Como pagar após o esgotamento do crédito de teste?
Recarga a partir de $20 até $500 com USDT na TRC20 ou USDC na Base. O crédito nunca expira.
Sua chave precisa de apenas um passo
Crie uma conta, copie sua chave, altere a URL base. É só isso no processo de configuração.