Modelli e costi API di Jan AI: endpoint locali, cloud e personalizzati

I modelli cloud di Jan AI non sono modelli di Jan. Jan non ospita alcun servizio di inferenza e non vende nulla, quindi per "modelli cloud" in Jan Desktop si intendono undici ponti integrati con chiave propria verso fornitori di terze parti, oltre a qualsiasi endpoint in formato OpenAI o Anthropic che aggiungi tu — ciascuno fatturato da chiunque si trovi dall’altra parte. L’applicazione in sé è gratuita: jan.ai/pricing ha restituito HTTP 404 alla verifica del 19 settembre 2026, e né Jan Desktop né Jan Agent documentano un piano, una postazione, un credito o una quota. Pertanto, l’unico numero da mettere a budget sono i token alla tariffa del tuo fornitore — oppure nulla per richiesta, se il modello viene eseguito sul tuo dispositivo.

Prima una disambiguazione, perché le ricerche li confondono. Janitor AI (janitorai.com) è un sito consumer di chat con personaggi e un prodotto completamente diverso; una quota significativa delle ricerche di "jan ai api key" si riferisce alla relativa chiave proxy. Se è questo ciò che stai configurando, inizia dalla configurazione di Janitor AI — in questa pagina non sono indicati prezzi o limiti per quel prodotto.

Tre prodotti condividono il marchio Jan e due condividono il nome del binario

È questo errore a confondere gli acquirenti sul fatto che Jan sia gratuito da eseguire. jan.ai elenca esattamente tre prodotti (homepage consultata il 18 settembre 2026):

• Jan Desktop — l’app stabile local-first. Ultima release contrassegnata v0.8.4, pubblicata il 23 luglio 2026; il repository non è archiviato ed è stato aggiornato l’ultima volta il 18 settembre 2026, con 44.551 stelle (API GitHub, 19 settembre 2026). Include i motori llama.cpp e MLX e può facoltativamente raggiungere provider cloud. Il repository si descrive come funzionante al 100% offline.
• Jan Agent — un agente terminale separato, distribuito autonomamente. Il relativo quickstart contiene un avviso di anteprima: il programma di installazione su dev recupera il canale agent-nightly. Non esiste alcuna release contrassegnata nel repository e il quickstart ne mostra una solo tramite jan --version, quindi qualsiasi informazione sui suoi flag è specifica della build installata.
• Tokamak — un backend self-hosted a livello di organizzazione con un proprio dominio di documentazione. La sua pagina non pubblica alcun prezzo, piano, numero di postazioni, credito o lista d’attesa, quindi questa pagina non ne cita nessuno — e l’assenza di condizioni pubblicate non equivale alla gratuità. È un backend self-hosted separato, non un piano a pagamento aggiunto a Jan Desktop, e jan login è il percorso documentato per raggiungerlo.

La documentazione di Jan sembra contraddirsi su questo punto, e la pagina dei provider è ciò che permette di conciliarla. Il testo introduttivo della documentazione descrive Jan Agent come uno strumento che avvia agenti su un modello locale; il quickstart afferma esplicitamente che Jan Agent non dispone di un motore di inferenza locale — chiama un provider remoto. Entrambe le affermazioni sono corrette, ma si riferiscono a cose diverse. L’Agent non esegue alcun modello autonomamente, quindi un modello viene sempre eseguito altrove — ma quel luogo può essere il tuo dispositivo: la pagina dei provider include una sezione "Your own hardware" che indirizza l’Agent verso il server API locale di Jan Desktop (http://localhost:6767/v1) e indica che, in questa configurazione, nulla lascia il dispositivo. Quindi l’Agent ha sempre bisogno di un endpoint; non ha sempre bisogno di uno a pagamento.

La collisione dei nomi peggiora il problema. La CLI proprietaria di Jan Desktop (disponibile da 0.7.8) e il binario Jan Agent vengono entrambi richiamati come jan, ma dispongono di insiemi di comandi diversi. Esistono quindi tre diversi "endpoint Jan": 127.0.0.1:1337 per il server API locale dell’interfaccia grafica Desktop, localhost:6767/v1 per jan serve dalla CLI Desktop e qualsiasi URL di base remoto verso cui è indirizzato un provider.

Prezzi di Jan AI: quanto costa il software e cosa viene fatturato

Una nota sulla licenza, perché la lettura automatica è errata: l’API di GitHub segnala NOASSERTION per questo repository, perché il file LICENSE è costituito da un preambolo personalizzato di Menlo Research seguito dall’avviso standard Apache 2.0 e da una richiesta di attribuzione, invece del testo Apache 2.0 letterale che uno scanner riconosce. Il file stesso afferma "Licensed under the Apache License, Version 2.0", quindi quella è la licenza, non il campo dell’API.

Gli undici provider cloud integrati e ciò che sono realmente

Jan Desktop inizializza ogni provider integrato con un URL di base in web-app/src/constants/providers.ts. Ognuno punta a una terza parte. Non esiste alcuna voce jan o menlo.

Letto da quel file il 18 settembre 2026. Nota lo schema seguito da ognuno: il percorso della versione fa parte dell’URL di base. Questa singola convenzione è la causa più comune dei problemi di configurazione in Jan ed è trattata qui sotto.

Tre elementi diversi chiamati "chiave API Jan AI"

I due significati entrano realmente in collisione all’interno di Jan, perché il suo server locale rispecchia entrambi i formati di rete. La documentazione sulle preferenze API di Jan mostra il server locale che espone GET /v1/models, POST /v1/chat/completions e un POST /v1/messages compatibile con Anthropic, autenticato con x-api-key. È la stessa struttura esposta da un gateway remoto — quindi lo stesso comando curl può essere indirizzato al tuo laptop o a un endpoint a pagamento, e solo l’host indica quale dei due stai usando.

Locale o cloud: decidi in base a memoria, contesto e necessità di lavorare offline

La base più oggettiva per questa decisione è pubblicata da Jan stessa nella pagina di installazione per Mac (macOS 13.6 o versione successiva, solo Apple Silicon — i Mac Intel non sono supportati — e almeno 10GB di spazio libero):

I requisiti minimi per Windows sono indicati separatamente nella pagina di installazione di Windows e includono un requisito minimo di VRAM: Windows 10 o versione successiva, almeno 8GB di RAM con 16GB consigliati, almeno 6GB di VRAM per GPU NVIDIA, AMD o Intel Arc, 10GB di spazio libero e supporto AVX2. Quella pagina non pubblica alcuna tabella della RAM per dimensione del modello. I requisiti Linux non sono stati verificati per questa pagina. Nell'app, l'Hub sostituisce i numeri con un verdetto — un indicatore colorato con la dicitura Fits, May be slow o Won't fit per ogni livello di quantizzazione — e specifica che non vengono scaricati dati per determinare lo stato di compatibilità.

Per quanto riguarda la scelta del modello: Jan documenta sette modelli proprietari — Jan-v3-4B, Jan-Code-4B, Jan-v1, Jan-v2-VL-med, Jan-Nano-32, Jan-Nano-128 e Lucy — con pesi aperti su Hugging Face nelle organizzazioni di Jan, janhq e Menlo. Non hanno tutti la stessa dimensione: la documentazione dei modelli indica 4B parametri per Jan-v3-4B e Jan-v1, 8B per Jan-v2-VL-med e 1.7B per Lucy. Jan-v3-4B offre inoltre un contesto nativo di 262.144 token, e la sua pagina dichiara chiaramente il proprio limite: 4B parametri limitano il ragionamento complesso a più passaggi rispetto ai modelli più grandi. Questa frase riassume in una riga l'argomento locale contro cloud. Usa il locale per attività circoscritte e privacy; passa al remoto quando l'attività supera il numero di parametri o la memoria disponibile.

API personalizzata di Jan Desktop: aggiungere un endpoint in formato OpenAI o Anthropic

Il percorso documentato è Settings → Model Providers → Add Provider. La pagina degli endpoint personalizzati di Jan (verificata il 19 settembre 2026) offre esattamente due formati di comunicazione — compatibile con OpenAI, indicato per vLLM, Ollama, LocalAI, TGI, server llama.cpp e LiteLLM in modalità OpenAI, e compatibile con Anthropic, per gli endpoint che espongono l'API Anthropic Messages — quindi richiede un nome del provider, un URL di base e una chiave API. Il campo della chiave è obbligatorio anche per i server locali senza chiave, per i quali va bene qualsiasi segnaposto.

Due dettagli determinano se funzionerà al primo tentativo.

Il percorso della versione appartiene all'URL di base. La documentazione di Jan indica questo come l'errore più comune, con queste parole: inserire http://localhost:8000 invece di http://localhost:8000/v1, causando un 404 a ogni richiesta. Per un provider in formato OpenAI destinato a Kunavo, ciò significa https://api.kunavo.com/v1.

Per il formato Anthropic, la documentazione di Jan non fornisce una regola — indica di usare la base documentata dal proprio gateway e il suo unico esempio è un'istanza locale di LiteLLM. Il codice sorgente di Jan chiarisce il punto: il percorso Anthropic si basa sul provider Anthropic dell'AI SDK di Vercel, il cui URL di richiesta viene costruito come {baseURL}/messages con un'intestazione x-api-key, e il cui URL di base predefinito include il prefisso della versione. Quindi https://api.kunavo.com/v1 è il valore da inserire, facendo arrivare la richiesta a /v1/messages. Questa è una lettura di due codebase, non un test, quindi consideralo il primo valore da provare — consulta la nota non verificata alla fine di questa pagina.

Questa distinzione trae in inganno, perché la guida di Kunavo su ANTHROPIC_BASE_URL indica l'opposto per una famiglia diversa di client: gli SDK ufficiali Anthropic e Claude Code aggiungono autonomamente /v1/messages, quindi richiedono l'origine nuda e l'aggiunta di /v1 produce /v1/v1/messages e un 404. Il provider in formato Anthropic di Jan non è uno di questi client. Se visualizzi un 404, il percorso duplicato nell'errore indica quale convenzione stai usando. L'endpoint Messages di Kunavo accetta sia l'intestazione Anthropic x-api-key sia Authorization: Bearer, mentre l'endpoint chat completions copre il percorso in formato OpenAI.

Individuazione dei modelli e delle funzionalità. Al salvataggio, Jan tenta di recuperare i modelli disponibili da {base_url}/models; se fallisce, devi inserire l'ID del modello esattamente come lo prevede il tuo server. Kunavo espone un elenco di modelli allo stesso prefisso, quindi l'individuazione dovrebbe funzionare sul percorso in formato OpenAI — non è documentato né verificato se Jan lo interroghi per un provider in formato Anthropic, quindi preparati ad aggiungere manualmente l'ID. Ancora più importante: i provider personalizzati non rilevano automaticamente le funzionalità. Jan dichiara di non poter dedurre se un modello supporti strumenti, visione o audio e chiede di aggiungere ogni modello manualmente e configurarne le funzionalità per modello. La sua documentazione MCP mostra l'altro lato: per un provider integrato come Anthropic, Jan legge automaticamente le funzionalità dei modelli del provider dopo l'aggiunta della chiave, e la voce di risoluzione dei problemi della pagina per «il modello non usa gli MCP che ho abilitato» consiste nel verificare che il modello abbia gli strumenti abilitati. Nessuna delle due pagine indica il valore predefinito di un modello personalizzato appena aggiunto, quindi controlla Model Capabilities prima di presumere che MCP sia attivo. Questa è la principale differenza pratica tra incollare una chiave nel provider Anthropic integrato e aggiungere un gateway come provider personalizzato.

L'app espone inoltre un campo Base URL per alcuni provider integrati, che consentirebbe di reindirizzare la voce Anthropic o OpenAI integrata verso un gateway. Nessuna pagina della documentazione di Jan tratta questo caso e questa pagina non ha eseguito l'app per confermarlo — considera il flusso Add Provider il percorso supportato.

Jan Agent utilizza gli stessi due formati come flag

La documentazione dei provider di Agent configura l'endpoint con --provider, --api-key, --base-url, --model (ripetibile) e --api-type, dove l'ultimo indica il protocollo di comunicazione, openai oppure anthropic, con valore predefinito compatibile con OpenAI.

# Jan Agent is a preview build from a nightly channel.
# Re-check these flags against your own `jan config --help` before relying on them.
jan config set \
  --provider kunavo \
  --api-type anthropic \
  --base-url https://api.kunavo.com/v1 \
  --api-key sk-kn-... \
  --model claude-sonnet-4-6

Le impostazioni vengono salvate in ~/.jan/config.toml, con una sostituzione per progetto in agent.toml sotto [provider] e una temporanea tramite JAN_API_KEY. La precedenza è documentata nel codice sorgente stesso, in providers.rs: la configurazione globale è la base, le impostazioni di Desktop vengono aggiunte come fonte ereditabile che non la sovrascrive mai, il file di progetto sovrascrive entrambe e i flag CLI più le variabili d'ambiente prevalgono su tutto. Entrambe le interfacce di Jan accettano inoltre più chiavi per provider e ritentano con quella successiva, applicando il retry nello stesso modo: la pagina degli endpoint personalizzati di Jan Desktop documenta il fallback solo per HTTP 401, 403 o 429, senza ritentare gli altri errori, e il codice sorgente di Agent applica gli stessi tre stati. Il messaggio key rotation exhausted appartiene a Jan Desktop e la sua pagina di risoluzione dei problemi lo interpreta come il fallimento di tutte le chiavi configurate con 401 o 403, non di una sola.

Se controlli personalmente il repository, qui incontrerai una trappola: un commento su stream_openai_chat_completions in core/agent/upstream.rs afferma che api_type «è None per ogni chiamante oggi» e che l'agent ha sempre usato OpenAI /chat/completions indipendentemente da esso. Quel commento descrive un helper ed è obsoleto per il resto: core/agent/loop.rs chiama resolve_api_type_for_model e costruisce un convertitore a partire da esso, e quel convertitore riscrive la richiesta su /messages con x-api-key e un'intestazione anthropic-version fissa (converters.rs). Quindi --api-type anthropic viene rispettato — e il commento del convertitore stesso indica che il base_url registrato dovrebbe includere il prefisso della versione, motivo per cui lo snippet sopra termina con /v1.

Quando non funziona

Le prime tre righe provengono dalla pagina di risoluzione dei problemi di Jan; le ultime due dalla pagina degli endpoint personalizzati. I log dell'app si trovano in ~/Library/Application Support/Jan/data/logs/app.log su macOS, %APPDATA%\Jan\data\logs\app.log su Windows e ~/.local/share/Jan/data/logs/app.log su Linux. Il riferimento degli errori di Kunavo tratta gli stessi codici di stato dal lato del gateway.

Un budget cloud calcolato per Jan

Queste cifre sono calcoli illustrativi basati sui token, non costi misurati delle attività e non un limite massimo della fattura. La colonna della chat presuppone una giornata in Jan Desktop di circa 40 turni, in cui il thread in crescita viene reinviato ogni volta — 240.000 token di input e 20.000 token di output. La colonna dell'agent presuppone una sessione più lunga con utilizzo di strumenti, pari a 400.000 token di input e 30.000 token di output. Entrambi i conteggi dei token sono modellazioni proprie di questa pagina, non dati pubblicati da Jan. Entrambi presumono l'assenza di letture dalla cache, perché non è stato verificato se il prompt caching sopravviva a un provider personalizzato in una delle due interfacce di Jan. Le tariffe sono i prezzi attuali del catalogo Kunavo per milione di token.

Due osservazioni. Primo, la differenza tra il modello meno costoso e quello più costoso nella tabella è circa 5,0x per la stessa sessione ipotizzata — un intervallo abbastanza ampio da rendere la scelta del modello la prima leva da azionare e da sostenere un percorso che consenta di cambiare modello senza aprire un nuovo account. Secondo, confronta onestamente quei totali con l'opzione locale: un modello che rientra nella tabella della RAM sopra costa $0 per richiesta, e Jan fornisce il motore necessario. Per un utente di Jan Desktop, il costo remoto è una scelta di capacità, non un costo per usare l'app.

Scala i valori in base alle tue giornate prima di considerarli un budget. L'importo del catalogo Kunavo è un minimo di fatturazione, non un tetto massimo: quando l'upstream comunica il proprio addebito, la fattura è il maggiore tra il costo del catalogo e il costo upstream moltiplicato per il markup applicabile. La ricarica minima è $10 di credito prepagato — un minimo di finanziamento, non una tariffa per attività né un abbonamento. Consulta i dettagli di fatturazione e l'ottimizzazione dei costi IA per il metodo basato su misurazione e scelta.

Quale route prevale quando

Se la riga del gateway è quella che stai valutando, la directory dei client indica come ogni client desktop e agent gestisce gli URL di base e i formati di comunicazione, mentre l'API compatibile con OpenAI tratta la convenzione seguita dal primo formato di Jan.

Configurazione e controllo della prima fattura

Tutto quanto sopra proviene dalla documentazione e dal codice sorgente pubblicati da Jan, oltre che dalla documentazione di Kunavo. Kunavo non ha testato a runtime Jan Desktop o Jan Agent: per questa pagina non è stata inviata alcuna richiesta tramite nessuna delle due app, quindi nulla di quanto riportato dimostra che le chiamate agli strumenti, lo streaming o l'individuazione dei modelli abbiano superato un test end-to-end. Considera gli URL di base come ciò che implicano i due insiemi di documentazione e confermali personalmente con un'attività circoscritta. Mantieni disponibile un percorso funzionante mentre lo provi, invia una richiesta di piccole dimensioni, poi leggi l'addebito effettivamente registrato dal tuo account invece di una qualsiasi stima presente in questa pagina. Crea un account Kunavo quando sei pronto a finanziare una chiave.

Domande frequenti

Ricontrollato il 21 settembre 2026: l'URL dei prezzi (ancora 404), il repository GitHub e la sua versione più recente (v0.8.4), la home page, la pagina Tokamak, la documentazione degli endpoint personalizzati, del server API, del riferimento API, di MCP, dell'installazione per Mac, dell'installazione per Windows, dell'Hub e della risoluzione dei problemi, il quickstart e la documentazione dei provider di Agent, la documentazione dei modelli proprietari, le organizzazioni Hugging Face e i file sorgente relativi alle costanti dei provider, al convertitore, all'upstream dell'agent e al ciclo dell'agent. I dati su stelle e ultimo push provengono dall'API GitHub del 19 settembre 2026 e cambiano quotidianamente. Non sono stati verificati: i requisiti di sistema Linux, le condizioni commerciali di Tokamak e il comportamento del caching tramite un provider personalizzato. Le tariffe dei token Kunavo provengono dal catalogo attuale e ogni cifra in dollari qui riportata è un calcolo illustrativo basato sui token, non un costo misurato dell'attività.