PT ▾
API de IA sem censura para uso livrehttps://api.apisemrestricoes.com/v1

Janitor AI API tutorial: configure em 6 passos

Este janitor ai api tutorial mostra como conectar o Janitor AI a uma API compatível com OpenAI, com URL, chave e modelo, e como resolver os erros mais comuns. Antes, um teste rápido por curl evita horas de tentativa e erro.

IA Sem Censura: Checklist Para Implementação em Produção

Atualizado

Balão de fala ligado por um cabo luminoso a um servidor, simbolizando a conexão do Janitor AI com uma API

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.

  1. Abra um chat com o personagem e entre nas configurações de API ou de geração do chat.
  2. 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.
  3. 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 base https://api.apisemrestricoes.com/v1, conforme o que o campo do site pedir.
  4. Informe a chave e o modelo. Cole a chave no campo de chave e escreva uncensored no campo do nome do modelo, exatamente assim, em minúsculas.
  5. 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 enviadoCusto da entradaCusto da saídaTotal por mensagemMensagens com US$ 0,50
8.000 tokensUS$ 0,0012US$ 0,00015US$ 0,00135cerca de 370
16.000 tokensUS$ 0,0024US$ 0,00015US$ 0,00255cerca 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 é Bearer seguido 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 e concurrency, 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 vier Retry-After: 5, espere 5 segundos.
  • Saldo zerado. Confira o cabeçalho X-Balance-USD ou o endpoint GET /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.

Mais guias

Perguntas frequentes

Preciso de um proxy próprio para usar o Janitor AI com esta API?

Não. No Janitor AI, "proxy" é o nome da opção para informar um endpoint compatível com a OpenAI. Você coloca a URL da API, a chave e o nome do modelo.

Qual nome de modelo coloco no Janitor AI?

Use uncensored, em minúsculas. É o único ID de modelo disponível neste endpoint.

Posso testar sem pagar?

Sim. Depois do cadastro, a página da chave permite resgatar US$ 0,50 de crédito de teste com um clique, válido por 7 dias.

A conexão falha mesmo com tudo certo. O que verifico?

Teste a chave e a URL por curl. Se o curl funciona, ajuste a forma da URL no campo do Janitor AI e consulte a ajuda dele, já que a interface pode mudar.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave e altere a URL base. É toda a configuração.