Documentação

Janitor AI

A configuração de proxy do Janitor AI requer a URL completa do endpoint, não uma URL base — o caminho termina em /chat/completions. Preencha corretamente esse campo; os demais são um nome, um ID de modelo e uma chave.

API Settings → Proxy → Add Configuration: Proxy URL é o caminho completo /v1/chat/completions, e Model Name deve ser exatamente um ID do catálogo.

Janitor AI · API Settings

☰ → API Settings → Proxy → + Add Configuration

  Config Name   Kunavo
  Model Name    claude-sonnet-5
  Proxy URL     https://api.kunavo.com/v1/chat/completions
  API Key       sk-kn-...

A Proxy URL é a URL completa do endpoint. O próprio guia do Janitor AI diz que ela precisa terminar em /chat/completions, então use https://api.kunavo.com/v1/chat/completions — não a URL base que você colaria em uma ferramenta de programação. Colar uma URL base aqui costuma ser a causa de um “proxy que não funciona”.

O Model Name precisa estar exato. O Janitor AI envia a string sem alterações, então um erro de digitação ou um nome de exibição resulta em um erro do endpoint, em vez de uma mensagem útil na interface. Copie os IDs de GET /v1/models ou de /models neste site.

Ainda não tem uma chave? Crie uma conta na Kunavo, gere uma chave (ela começa com sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de Janitor AI.

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
Abra qualquer conversa, clique no menu ☰ na parte superior e escolha API Settings.
Selecione Proxy e depois + Add Configuration.
Preencha Config Name, Model Name, Proxy URL e API Key exatamente como acima e salve.
Envie uma mensagem. Uma resposta indica que o proxy funciona; um erro que menciona o modelo aponta para o Model Name, e um erro que menciona a URL aponta para o caminho.

Verificado em Guia oficial de proxy do Janitor AI em 6 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em Janitor AI.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

ID do modelo	Entrada / saída da Kunavo	Onde se encaixa em Janitor AI
`claude-sonnet-5`	$1.40 / $7.00	a opção padrão — o equilíbrio que a maioria das pessoas procura
`claude-haiku-4-5`	$0.70 / $3.50	o menor custo por turno e rápido
`claude-opus-5`	$3.50 / $17.50	a opção mais cara; verifique o custo por turno antes de se comprometer
`gpt-5-6-terra`	$0.70 / $4.20	conversas longas, em que o limite é o tamanho do contexto

A cobrança é por token, usando um saldo pré-pago e sem tarifa mensal — consulte billing. Em contextos repetidos — que representam a maior parte do que um editor ou cliente de chat envia — o cache de prompt altera a conta mais do que a escolha do modelo.

Perguntas frequentes

Qual Proxy URL o Janitor AI requer?

O endpoint completo de chat completions, não uma URL base. O próprio guia do Janitor AI informa que a URL precisa terminar em /chat/completions e dá como exemplo um caminho completo; portanto, para um serviço compatível com OpenAI, use https://<host>/v1/chat/completions. Informar a URL base é o motivo mais comum para um proxy configurado corretamente não retornar nada.

Como configuro um proxy personalizado no Janitor AI?

Abra uma conversa, clique no menu ☰, escolha API Settings, selecione Proxy e clique em + Add Configuration. Preencha Config Name, o Model Name exato, Proxy URL terminada em /chat/completions e API Key; depois salve e envie uma mensagem de teste. Uma resposta confirma os quatro campos de uma só vez.

Por que o Janitor AI informa que o modelo não foi encontrado?

Porque o Model Name é enviado ao endpoint literalmente e precisa corresponder exatamente a um ID de modelo real — nomes de exibição, diferenças entre maiúsculas e minúsculas e espaços no final causam falha. Copie o ID da lista de modelos do provedor ou de uma chamada GET /v1/models, em vez de digitá-lo de memória.

Usar um proxy no Janitor AI custa dinheiro?

O custo depende do que o endpoint por trás do proxy cobra. O Janitor AI não cobra pelo uso do proxy; o provedor da API cobra por token, por cada mensagem enviada na conversa — em uma conversa longa de interpretação de papéis, isso inclui todo o histórico em cada turno. Escolher um modelo mais barato e um endpoint com cache de prompts é o que mantém a conta baixa.