Pontos principais
- Teste a chave por curl antes de mexer no Janitor AI
- Base URL e modelo uncensored são os dois campos que mais dão erro
- Mensagens com 8.000 tokens de contexto custam cerca de US$ 0,00135
- Reduza o contexto se a conversa ficar cara ou lenta
O que você precisa antes de começar
O Janitor AI é um site de chat com personagens, usado para ficção e roleplay entre adultos. Ele permite configurar uma API própria nas configurações do chat, e é aí que entra um endpoint compatível com a OpenAI. Esta parte do janitor ai api tutorial lista o que você precisa ter em mãos:
- uma conta no Janitor AI e a idade mínima exigida pelo próprio site;
- uma chave de API, que você obtém na página da chave depois do cadastro;
- a base URL
https://api.apisemrestricoes.com/v1; - o ID do modelo:
uncensored.
Se ainda não tem saldo, o cadastro permite resgatar US$ 0,50 de crédito de teste com um clique, uma vez por pessoa e válido por 7 dias. Isso é suficiente para um bom número de mensagens de teste, como mostra o cálculo mais abaixo.
Passo 1: teste a chave fora do Janitor AI
O erro mais comum é culpar o Janitor AI por um problema que está na chave ou na URL. Teste primeiro por curl. Se funcionar aqui, o resto é só copiar os valores.
curl https://api.apisemrestricoes.com/v1/chat/completions \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "Você é um narrador de fantasia."},
{"role": "user", "content": "Descreva a entrada de uma taverna em duas frases."}
],
"max_tokens": 150
}'Uma resposta em JSON, com o texto em choices[0].message.content, confirma que a chave, o modelo e a rede estão certos. Se vier erro aqui, corrija antes de seguir.
Quer ver o texto chegando aos poucos, como no chat? O mesmo teste em Python, com streaming, usa o SDK da OpenAI:
from openai import OpenAI
client = OpenAI(base_url="https://api.apisemrestricoes.com/v1", api_key="SUA_CHAVE")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Continue a cena da taverna."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")O streaming usa SSE e entrega o uso de tokens no final. Enquanto o fluxo não termina, a requisição ocupa uma das vagas de concorrência da chave.
Passo 2 a 5: configurar a API no Janitor AI
Os nomes exatos de menus e botões do Janitor AI mudam com o tempo, então descrevo o caminho de forma geral. Em caso de dúvida, consulte a ajuda do próprio site.
- Abra um chat com o personagem e entre nas configurações de API ou de geração do chat.
- Escolha a opção de API própria ou proxy, em vez do modelo padrão do site. É o campo que permite informar um endereço seu.
- Preencha a URL. Muitos guias usam o endereço completo do método de chat, ou seja,
https://api.apisemrestricoes.com/v1/chat/completions. Se a conexão falhar com essa forma, teste também a basehttps://api.apisemrestricoes.com/v1, conforme o que o campo do site pedir. - Informe a chave e o modelo. Cole a chave no campo de chave e escreva
uncensoredno campo do nome do modelo, exatamente assim, em minúsculas. - Salve e envie uma mensagem de teste. Se a resposta chegar, o Janitor AI está falando com a API.
Tratar o endereço como "proxy" é só o nome que o site dá à opção. Por trás, é uma chamada POST /v1/chat/completions no formato da OpenAI.
Passo 6: ajustar contexto e tamanho da resposta
O Janitor AI tem seus próprios controles de geração, e eles afetam diretamente o custo e a qualidade.
Contexto
A janela do modelo é de 100.000 tokens, somando prompt e resposta. Não é preciso (nem barato) encher isso. Em conversas de roleplay, o histórico é reenviado a cada mensagem, então um contexto grande significa uma entrada grande em cada resposta. Um valor entre 8.000 e 16.000 tokens costuma ser um bom ponto de partida.
Tamanho da resposta
Se as respostas saem curtas ou cortadas, aumente o limite de tokens novos nas configurações do site. O parâmetro max_tokens é opcional na API, e a resposta pode usar o resto da janela.
Temperatura
Valores mais altos dão respostas mais variadas, e valores baixos, mais previsíveis. Os parâmetros temperature, top_p, stop, seed e as penalidades são repassados ao modelo.
Quanto custa cada mensagem
O preço é US$ 0,15 por 1M de tokens de entrada e US$ 0,50 por 1M de saída. Em roleplay, a entrada pesa mais, porque inclui a ficha do personagem, as instruções e o histórico. Dois cenários, com resposta de 300 tokens:
| Contexto enviado | Custo da entrada | Custo da saída | Total por mensagem | Mensagens com US$ 0,50 |
|---|---|---|---|---|
| 8.000 tokens | US$ 0,0012 | US$ 0,00015 | US$ 0,00135 | cerca de 370 |
| 16.000 tokens | US$ 0,0024 | US$ 0,00015 | US$ 0,00255 | cerca de 196 |
Uma recarga de US$ 20 rende, no primeiro cenário, cerca de 14.800 mensagens (20 dividido por 0,00135). Dobrar o contexto praticamente dobra o custo, então só aumente se a história realmente precisar de memória longa. Veja a tabela de recargas e bônus em preços.
Erros comuns e como corrigir
- "Network error" ou erro de conexão. Confira a URL: erro de digitação, falta do
https://ou do/v1. Teste a mesma URL por curl. - Erro de autenticação. A chave está incompleta ou com espaço. O formato é
Bearerseguido da chave, e o site cuida disso quando você preenche o campo certo. - Erro de modelo. O único ID é
uncensored. Nomes de modelos de outras empresas não existem neste endpoint. - HTTP 429. O código
rate_limitedé excesso de requisições por minuto econcurrency, excesso de requisições ao mesmo tempo. Na chave de teste o limite é de 2 simultâneas e 60 por minuto; na chave completa, 8 e 300. Evite abrir vários chats gerando ao mesmo tempo. Se vierRetry-After: 5, espere 5 segundos. - Saldo zerado. Confira o cabeçalho
X-Balance-USDou o endpointGET /v1/balance. - Chats lentos ou que falham de vez em quando. Contextos muito grandes aumentam o tempo de resposta. Reduza o contexto e, se houver um 429 com
Retry-After: 5, tente de novo depois de alguns segundos em vez de reenviar em sequência. - Resposta que não respeita o personagem. Isso costuma ser prompt, não conexão. Refine a descrição do personagem e as instruções.
Segurança e limites de uso
Você vai colar uma chave de API em um site de terceiros. Por isso, use o saldo que está disposto a arriscar e não reutilize a mesma chave em outros projetos. Leia também a política de privacidade do Janitor AI, já que as conversas passam pelo serviço dele. Nesta API, os prompts não são usados para treinamento.
Uma prática simples ajuda: use uma chave só para o Janitor AI e recarregue valores pequenos. As recargas vão de US$ 20 a US$ 500, em USDT na rede TRC20 ou USDC na rede Base, e o crédito não expira, então o saldo parado não se perde. Se a chave vazar, o prejuízo fica limitado ao que havia de saldo.
O modelo é aberto, hospedado por um provedor independente e responde sem recusas de conteúdo para uso adulto legal. Conteúdo sexual envolvendo menores é proibido, sem exceção. A API gera só texto. Para a configuração em produção de qualquer app, leia o checklist de produção, e para os detalhes de cada endpoint, a documentação.

