Documentazione

Janitor AI

La configurazione proxy di Janitor AI richiede l'URL completo dell'endpoint, non un URL di base: il percorso termina con /chat/completions. Inserisci correttamente questo campo e per il resto bastano un nome, un ID modello e una chiave.

API Settings → Proxy → Add Configuration: Proxy URL è il percorso completo /v1/chat/completions, e Model Name deve essere esattamente un ID del catalogo.

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-...

L'URL del proxy è un URL endpoint completo. La guida ufficiale di Janitor AI specifica che deve terminare con /chat/completions, quindi si tratta di https://api.kunavo.com/v1/chat/completions — non dell'URL di base che inseriresti in uno strumento di coding. Incollare qui un URL di base è la causa più comune del messaggio «il proxy non funziona».

Il nome del modello deve essere esatto. Janitor AI invia la stringa senza modificarla, quindi un errore di battitura o un nome visualizzato restituisce un errore dall'endpoint invece di un messaggio utile nell'interfaccia. Copia gli ID da GET /v1/models o da /models su questo sito.

Non hai ancora una chiave? Crea un account Kunavo, genera una chiave (inizia con sk-kn-) e aggiungi credito da $10: le chiamate vengono pagate con quel saldo e le chiamate non riuscite non vengono addebitate. La dashboard si apre quindi sulla configurazione Janitor AI.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
Apri una chat, fai clic sul menu ☰ in alto e scegli Impostazioni API.
Seleziona Proxy, poi + Aggiungi configurazione.
Inserisci Nome configurazione, Nome modello, URL del proxy e Chiave API esattamente come indicato sopra, poi salva.
Invia un messaggio. Se ricevi una risposta, il proxy funziona; un errore che indica il modello riguarda il Nome modello, mentre uno che indica l'URL riguarda il percorso.

Verificato rispetto a Guida ufficiale ai proxy di Janitor AI il 6 settembre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.

Verifica prima di eseguire il debug del client

Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano in 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-..."

Quale model id inserire nel campo

Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.

ID del modello	Kunavo ingresso / uscita	Dove si inserisce in Janitor AI
`claude-sonnet-5`	$1.40 / $7.00	l'impostazione predefinita — il giusto equilibrio per la maggior parte delle persone
`claude-haiku-4-5`	$0.70 / $3.50	il costo per turno più basso e prestazioni rapide
`claude-opus-5`	$3.50 / $17.50	quello costoso; verifica il costo per turno prima di impegnarti
`gpt-5-6-terra`	$0.70 / $4.20	per le conversazioni lunghe, in cui il limite è la dimensione del contesto

La fatturazione è per token, usando un saldo prepagato senza canone mensile: vedi billing. In presenza di contesto ripetuto, che costituisce la maggior parte di ciò che invia un editor o un client di chat, prompt caching incide sulla spesa più della scelta del modello.

Domande frequenti

Quale URL del proxy richiede Janitor AI?

L'endpoint completo per le chat completions, non un URL di base. La guida ufficiale di Janitor AI afferma che l'URL deve terminare con /chat/completions e riporta un percorso completo come esempio; per un servizio compatibile con OpenAI, quindi, è https://<host>/v1/chat/completions. Inserire l'URL di base è il motivo più comune per cui un proxy configurato correttamente non restituisce nulla.

Come configuro un proxy personalizzato in Janitor AI?

Apri una chat, fai clic sul menu ☰, scegli Impostazioni API, seleziona Proxy e fai clic su + Aggiungi configurazione. Inserisci un Nome configurazione, il Nome modello esatto, l'URL del proxy che termina con /chat/completions e la Chiave API, poi salva e invia un messaggio di prova. Se ricevi una risposta, tutti e quattro i campi sono corretti.

Perché Janitor AI dice che il modello non è stato trovato?

Perché il Nome modello viene inviato all'endpoint senza modifiche e deve corrispondere esattamente a un ID modello reale: nomi visualizzati, differenze tra maiuscole e minuscole e spazi finali causano tutti un errore. Copia l'ID dall'elenco dei modelli del provider o da una richiesta GET /v1/models, invece di digitarlo a memoria.

Usare un proxy in Janitor AI costa?

Il costo dipende da quanto addebita l'endpoint dietro al proxy. Janitor AI non fattura l'uso del proxy; lo fa il provider API, per token e per ogni messaggio inviato nella conversazione — che, in una lunga chat di gioco di ruolo, include l'intera cronologia a ogni turno. Scegliere un modello meno costoso e un endpoint con caching dei prompt è ciò che mantiene bassa la spesa.