O Janitor AI não tem modelo próprio: quem responde às suas conversas é o modelo que você conecta. Este tutorial mostra como ligar o DeepSeek à plataforma em quatro etapas e o que fazer quando a primeira mensagem volta com erro.
Por que o Janitor AI precisa de um modelo externo
O Janitor AI é uma plataforma de chatbot com personagens criados pela comunidade. Ele cuida da interface, das fichas de personagem e da memória da conversa, mas não roda um modelo de linguagem próprio. As respostas vêm de uma API que você mesmo indica.
Isso assusta no começo e vale a pena entender. Em troca do trabalho de configurar uma chave, você escolhe qual modelo pensa pelas suas conversas e quanto quer pagar por isso. O DeepSeek entrou nessa conversa por um motivo simples: o custo por token é baixo e o comportamento é próximo dos modelos grandes.
Quem procura "how to set up deepseek on janitor ai" normalmente já testou o modelo padrão, achou as respostas lentas ou caras, e quer uma alternativa. O caminho todo leva uns dez minutos. Se você nunca mexeu em configurações de API antes, não se preocupe: são três campos e um teste simples no final.
A regra que evita 90% dos erros
Antes de qualquer clique, entenda o princípio: a URL, a chave e o nome do modelo precisam pertencer à mesma rota. Misturar peças de fornecedores diferentes é a causa mais comum de falha.
Existem duas rotas válidas, e você escolhe uma antes de começar.
Rota direta. Você cria uma conta na plataforma da DeepSeek, gera a chave lá e usa o endereço https://api.deepseek.com. A cobrança sai da sua conta DeepSeek, sem intermediário.
Rota por provedor. Você usa um serviço como o OpenRouter, que reúne vários modelos sob uma única chave. Aqui o Janitor AI não fala com a DeepSeek diretamente: ele manda o pedido para o provedor, que decide qual modelo atende. O nome do modelo precisa ser exatamente o que aparece no painel do provedor.
Uma chave da DeepSeek com endereço do OpenRouter falha. Uma chave do OpenRouter com endereço da DeepSeek também falha. Quando isso acontece, o problema não é o seu personagem nem o seu prompt: é a mistura de rotas.
Vale fazer a pergunta certa antes de começar: você quer a conta e a cobrança na mão, ou prefere uma chave só para vários modelos? A resposta define a rota, e a rota define todo o resto.
Passo a passo dentro do Janitor AI
O fluxo oficial passa por abrir uma conversa, entrar nas configurações de API, adicionar uma configuração e preencher os três campos. Siga nesta ordem.
- Faça login no Janitor AI e entre em qualquer chat, porque as configurações de proxy ficam acessíveis pelo próprio chat.
- Clique no ícone de engrenagem no topo da janela de conversa para abrir as configurações.
- Localize a área de API Settings ou Proxy Settings. É ali que ficam as conexões personalizadas.
- Escolha Add Configuration (ou o botão equivalente para adicionar um proxy personalizado).
- Se o Janitor pedir o tipo de rota, selecione a opção compatível com a OpenAI, que é o padrão usado pelo DeepSeek.
- Cole a Proxy URL da sua rota:
https://api.deepseek.comse for a rota direta, ou o endereço do provedor caso tenha escolhido a outra via. - Cole a API Key gerada na mesma rota.
- Digite o Model Name exatamente como aparece na lista do fornecedor.
- Salve a configuração.
- Recarregue a página por completo, ou reabra a conversa, antes de testar.
O passo 10 é o mais ignorado. Sem recarregar, o Janitor AI pode continuar usando a configuração anterior e você vai culpar o modelo por um erro que era cache guardado no navegador desde a última sessão.
Qual nome de modelo usar
Aqui mora o erro silencioso. Tutoriais antigos citam nomes como deepseek-chat e deepseek-reasoner, mas essa nomenclatura está sendo aposentada. Os identificadores diretos atuais da DeepSeek são deepseek-v4-flash e deepseek-v4-pro.
A regra prática: consulte a lista de modelos viva do seu fornecedor, não uma captura de tela de 2024. Se você usa a rota por provedor, o nome tem que ser o slug que aparece no painel dele, e não o nome que você viu na documentação da DeepSeek. São catálogos diferentes.
Testando e lendo os erros
O primeiro teste deve ser chato de propósito. Mande uma mensagem curta, do tipo "responda em uma frase confirmando que a API está conectada". Se essa mensagem simples falhar, o problema está na configuração, não no seu prompt nem na ficha do personagem.
Quando der erro, leia o código em vez de trocar modelos aleatoriamente.
Código | O que costuma significar | Onde olhar |
|---|---|---|
401 | Chave inválida ou de outro fornecedor | Regenere a chave na rota correta |
404 | Endereço ou nome de modelo errado | Confira URL e slug do modelo |
429 | Cota esgotada ou limite do provedor | Verifique saldo e limites de uso |
Erro de rede | Problema de conexão, cache ou VPN | Recarregue, limpe o cache, teste a conexão |
Um 401 quase sempre é chave de uma rota com endereço de outra. Um 404 quase sempre é nome de modelo desatualizado.
Ajustes depois que a conexão funciona
Com a API respondendo, o Janitor AI expõe campos que mudam bastante a experiência. Vale mexer neles com critério, um de cada vez.
- Global Prompt. Um texto aplicado a todas as conversas. Deixe vazio no início e preencha só quando perceber um vício recorrente nas respostas.
- Prefill. Força o começo da resposta do modelo. Ajuda a manter o tom, mas exagera em respostas robóticas se você preencher demais.
- Memória. Guarda fatos da conversa entre mensagens. Liga conforme o tamanho do chat, porque memória demais pesa no custo.
- Temperatura. Controla a variação das respostas. Valores baixos deixam tudo previsível; valores altos criam mais surpresa e mais incoerência.
Comece com os padrões e mude uma opção por vez. Trocar quatro campos de uma vez e não entender o que mexeu no resultado é o jeito mais rápido de se perder entre configurar e desistir da plataforma.
Quando o modelo responde devagar
A lentidão não é do Janitor AI. A plataforma só envia o pedido; o tempo de resposta depende do provedor do modelo. Nos horários de pico, a fila do fornecedor aumenta e a espera cresce, mesmo com a sua conexão estável e o personagem bem configurado.
Se a lentidão incomodar, a saída é trocar para um modelo mais leve dentro da mesma rota ou, na rota por provedor, escolher um endpoint em outra região. Não adianta reconfigurar o personagem: o gargalo está fora da plataforma.
O que fazer agora
Monte a rota direta se você quer controle total sobre a conta e a cobrança, e fique com um provedor se prefere uma chave só para vários modelos. Em qualquer caso, comece com um teste de uma frase, confira o nome do modelo na lista viva do fornecedor e só depois ajuste prompt e memória. Conectar o DeepSeek ao Janitor AI é um trabalho de configuração de dez minutos, e o retorno aparece já na primeira conversa longa.
