---
title: "Jan: endpoint personalizzato per un’API compatibile OpenAI"
description: "Aggiungi BroadNet Inference all’app desktop Jan come provider personalizzato compatibile con OpenAI, inserisci gli ID dei modelli e attiva strumenti e visione."
url: https://broadrouter.com/it/guides/jan-custom-endpoint/
lang: it
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/guides/jan-custom-endpoint/) (aggiornato il 2026-11-16).

# Usare Jan con BroadNet Inference come provider compatibile OpenAI

Aggiornato 2026-11-16

In Jan apri Settings, Model Providers e clicca Add Provider. Scegli OpenAI-compatible, chiamalo BroadNet, imposta Base URL su https://inference.broadnet.ai/v1 e incolla la tua chiave BroadNet. Poi aggiungi a mano i modelli di chat con il pulsante +, per esempio broadnet/glm-5.3, e per ogni modello attiva Tools o la visione nelle sue capability.

Jan è un’app desktop open source per chattare, che esegue modelli locali e si collega ad API cloud. Qualsiasi servizio che parli il formato OpenAI si può aggiungere come **provider personalizzato**. BroadNet Inference serve chat completions standard su `https://inference.broadnet.ai/v1`. BroadRouter è il sito di BroadNet; i passaggi seguono [la pagina Custom Endpoints di Jan](https://docs.jan.ai/desktop/remote-models/custom-endpoint) alla versione 0.8.8.

## Configurazione

1.  **Procurati una chiave.** Crea una chiave a consumo nella console di BroadNet, oppure acquista una chiave oraria o un piano.
    
2.  **Apri la finestra.** Vai in **Settings** > **Model Providers** e clicca il pulsante **Add Provider** accanto all’elenco.
    
3.  **Scegli il formato dell’API.** Seleziona **OpenAI-compatible**, il default.
    
4.  **Compila i dati:**
    
    | Campo | Valore |
    | --- | --- |
    | Provider name | BroadNet |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API key | la tua chiave BroadNet |
    
5.  Clicca **Create**.
    
6.  **Aggiungi i modelli a mano.** Nella sezione **Models** del provider, clicca **+** e inserisci esattamente ogni ID di modello di chat, per esempio `broadnet/glm-5.3`.
    
7.  **Imposta le capability.** Clicca la matita accanto a ogni modello e attiva ciò che supporta (tabella qui sotto). Per i provider personalizzati Jan non lo rileva da solo.
    
8.  **Provalo.** Apri una nuova chat, scegli il modello BroadNet nel selettore dei modelli e invia un breve messaggio.
    

Quando salvi, Jan scarica `https://inference.broadnet.ai/v1/models`. La documentazione di BroadNet descrive quell’endpoint come metadati del catalogo per i sistemi di monitoraggio, e al nostro controllo del 15 novembre 2026 elencava solo i due modelli di trascrizione. Quelli non possono chattare; rimuovili se compaiono.

## ID dei modelli e capability

| Modello | ID | Strumenti | Immagini | Contesto |
| --- | --- | --- | --- | --- |
| GLM 5.3 | `broadnet/glm-5.3` | Sì | No | 1.048.576 |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | Sì | Sì | 262.144 |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | No (non indicati da BroadNet) | Sì | 1.048.576 |
| BroadNet Gemma 4 VL 26B | `broadnet/gemma-4-26b-a4b` | No | Sì | 32.768 |

`broadnet/gemma-4-26b-a4b` è l’unico modello di chat che funziona con il credito iniziale di $5, ed è il modello dietro la [chiave oraria](https://broadrouter.com/it/blog/hourly-llm-api-key-explained/) di BroadNet ($0.50 per un’ora, uno stream). Gli altri richiedono una ricarica oppure, per DeepSeek V4.1 Flash, un [piano illimitato](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/).

## Impostazioni da modificare

-   **Limite di output.** Tre dei modelli ragionano prima di rispondere, e il ragionamento conta in `max_tokens`. Se imposti un limite di output per un modello BroadNet, tienilo a 1.000 token o più.
-   **Sampler.** Per i provider personalizzati Jan espone l’intero set di parametri di sampling, e la sua documentazione avverte che gli endpoint personalizzati possono ignorare in silenzio i sampler che non supportano. Se un’impostazione come min-P sembra non avere effetto, il motivo è questo.
-   **Chiavi di riserva.** Jan può tenere più chiavi per provider e riprova con la successiva in caso di 401, 403 o 429. La [Politica di utilizzo accettabile](https://www.broadnet.ai/aup) di BroadNet vieta di aggirare i limiti di frequenza o di concorrenza, quindi usa le chiavi in più per il failover, non per moltiplicare i tuoi limiti.

## Risoluzione dei problemi

-   **404 su ogni richiesta.** Al Base URL manca `/v1`. La documentazione di Jan lo indica come l’errore più comune.
-   **401 o 403.** La chiave è sbagliata, scaduta o ha esaurito la quota. Un esito positivo di **Test keys** non dimostra che la chiave funzioni, perché al nostro controllo il `/v1/models` di BroadNet rispondeva anche senza chiave.
-   **Modello non trovato.** Controlla l’ID, compreso il prefisso `broadnet/`. I modelli a pagamento richiedono una ricarica.
-   **Risposte vuote.** Il ragionamento ha consumato il budget di output. Alza il limite di output. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **429.** Una chiave a consumo consente 30 richieste al minuto e 4 in corso contemporaneamente; una chiave oraria esegue uno stream alla volta. Vedi [errori e retry](https://broadrouter.com/it/guides/errors-and-retries/).

## Termini in questa guida

[Base URL (URL di base)](https://broadrouter.com/it/glossary/base-url/)

La base URL è l’indirizzo radice fisso di un’API, come https://api.example.com/v1, che un client antepone a ogni percorso di endpoint, come /chat/completions. Negli SDK compatibili con OpenAI, cambiare la base URL, insieme alla chiave API e all’ID del modello, punta lo stesso codice verso un altro provider.

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

[Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/)

La concorrenza è il numero di richieste che un client ha in corso nello stesso momento. Le API LLM spesso la limitano per chiave o per piano, separatamente dalle richieste al minuto, perché ogni richiesta aperta occupa capacità GPU finché la sua risposta non è terminata.

[Credito prepagato (prepaid credit)](https://broadrouter.com/it/glossary/prepaid-credit/)

Il credito prepagato è denaro aggiunto a un account API prima dell’uso. Ogni richiesta scala il proprio costo dal saldo e, quando il saldo si esaurisce, le richieste a consumo si fermano finché non ricarichi. Limita la spesa a quanto hai versato.

[Rate limit (limite di frequenza)](https://broadrouter.com/it/glossary/rate-limit/)

Un rate limit è un tetto che un’API pone a quanto un client può usarla in un intervallo di tempo, per esempio richieste al minuto o token al minuto. Le richieste oltre il limite vengono rifiutate, di solito con HTTP 429 Too Many Requests, finché l’uso non torna sotto la soglia.

[Token](https://broadrouter.com/it/glossary/token/)

Un token è l’unità di testo che un modello linguistico legge e scrive: una parola, una parte di parola, un segno di punteggiatura o una sequenza di byte prodotta dal tokenizer del modello. Le API LLM contano, limitano e di solito fatturano l’uso in token.

[Chat Completions API](https://broadrouter.com/it/glossary/chat-completions-api/)

La Chat Completions API è l’endpoint HTTP di OpenAI, POST /v1/chat/completions, che riceve il nome di un modello e una lista di messaggi con un ruolo e restituisce il messaggio successivo del modello. La forma della sua richiesta e risposta è diventata il formato comune che riusano provider e SDK compatibili con OpenAI.

[Chiave API (API key)](https://broadrouter.com/it/glossary/api-key/)

Una chiave API è una stringa segreta che identifica e autorizza un client che chiama un’API. Le API LLM di solito la vogliono in un header Authorization: Bearer, e chiunque possieda la chiave può fare richieste fatturate all’account a cui appartiene.

## Domande frequenti

### Perché Jan mostra solo modelli di trascrizione dopo che aggiungo BroadNet?

Quando salvi, Jan scarica https://inference.broadnet.ai/v1/models. Al nostro controllo del 15 novembre 2026, il /v1/models pubblico di BroadNet elencava solo i suoi due modelli di trascrizione, che non funzionano in chat. Rimuovili e aggiungi a mano gli ID dei modelli di chat.

### Il pulsante Test keys di Jan dice OK. La mia chiave è valida?

Non per forza. Jan verifica le chiavi chiamando /models, e al nostro controllo il /v1/models di BroadNet rispondeva anche senza chiave. Invia un messaggio in chat per confermare la chiave.

### Posso usare in Jan la chiave oraria di BroadNet?

Sì. La chiave oraria fa girare BroadNet Gemma 4 VL 26B, ID broadnet/gemma-4-26b-a4b, con uno stream alla volta, il che va bene per una singola finestra di chat.

### Jan rileva se un modello BroadNet supporta immagini o strumenti?

No. La documentazione di Jan dice che per i provider personalizzati le capability non vengono rilevate. Attiva l’input di immagini per DeepSeek V4.1 Flash, Qwen3.8 27B e Gemma 4 VL 26B, e Tools per GLM 5.3 e Qwen3.8 27B.

## Guide correlate

-   [Collegare Open WebUI a BroadNet Inference](https://broadrouter.com/it/guides/open-webui-openai-api/)
-   [Aggiungere BroadNet Inference a LibreChat come custom endpoint](https://broadrouter.com/it/guides/librechat-custom-endpoint/)
-   [Collegare SillyTavern a BroadNet Inference (Custom OpenAI-compatible)](https://broadrouter.com/it/guides/sillytavern-custom-openai-endpoint/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Tutti gli strumenti che funzionano con BroadNet Inference (in inglese)](https://broadrouter.com/integrations/): SDK, agenti di coding, interfacce di chat e strumenti di automazione, con le impostazioni esatte per ciascuno

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-jan-custom-endpoint&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di Jan, Custom Endpoints (verificata il 2026-11-15)](https://docs.jan.ai/desktop/remote-models/custom-endpoint)
-   [Release di Jan su GitHub, ultima v0.8.8 (verificato il 2026-11-15)](https://github.com/janhq/jan/releases)
-   [Politica di utilizzo accettabile di BroadNet (verificata il 2026-11-15) (in inglese)](https://www.broadnet.ai/aup)
-   [Riferimento API di BroadNet Inference (verificato il 2026-11-15) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-jan-custom-endpoint&utm_content=sources)
