---
title: "Open WebUI con un endpoint compatibile con OpenAI | BroadRouter"
description: "Aggiungi BroadNet Inference a Open WebUI come connessione compatibile con OpenAI, metti gli ID dei modelli in allowlist e risolvi verifica, risposte vuote e 429."
url: https://broadrouter.com/it/guides/open-webui-openai-api/
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/open-webui-openai-api/) (aggiornato il 2026-11-16).

# Collegare Open WebUI a BroadNet Inference

Aggiornato 2026-11-16

In Open WebUI vai su Settings > Connections nella sezione di amministrazione, clicca Add Connection sotto Manage OpenAI API Connections, imposta URL su https://inference.broadnet.ai/v1 e API Key con la tua chiave BroadNet, poi aggiungi gli ID dei modelli, per esempio broadnet/glm-5.3, alla allowlist Model IDs e salva.

Open WebUI è un’interfaccia di chat self-hosted. Si collega a qualsiasi provider che implementa il protocollo chat completions di OpenAI, e BroadNet Inference lo fa. I passaggi seguono [la guida di Open WebUI per i provider compatibili con OpenAI](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible).

## Configurazione

1.  **Procurati una chiave BroadNet.** Per un’interfaccia di chat usata da più persone, la scelta giusta è una chiave a consumo. Vedi [chiavi API e allowlist di IP](https://broadrouter.com/it/guides/api-keys-ip-allow-lists/).
    
2.  **Apri la pagina delle connessioni.** Vai su **Settings > Connections** nella sezione di amministrazione e trova **Manage OpenAI API Connections**.
    
3.  **Clicca Add Connection** e compila:
    
    | Campo | Valore |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (senza slash finale) |
    | API Key | la tua chiave BroadNet |
    | Model IDs | aggiungi ciascun ID qui sotto, uno alla volta, con l’icona **+** |
    
4.  **Aggiungi a mano gli ID dei modelli.** Scrivi `broadnet/glm-5.3`, clicca **+** e ripeti per gli altri che ti servono. La documentazione di BroadNet descrive `GET /v1/models` come metadati pubblici del catalogo per i sistemi di monitoraggio, quindi non contare su quell’endpoint per riempire il selettore dei modelli.
    
5.  **Clicca Save.** La documentazione di Open WebUI precisa che il salvataggio non verifica la connessione.
    
6.  **Avvia una chat** e scegli il modello dal selettore.
    

### Con le variabili d’ambiente

Se esegui Open WebUI in Docker, puoi impostare la connessione all’avvio:

```bash
OPENAI_API_BASE_URL=https://inference.broadnet.ai/v1
OPENAI_API_KEY=your-broadnet-key
```

Per aggiungere BroadNet accanto a una connessione OpenAI esistente, usa le forme plurali, con i valori separati da punto e virgola: `OPENAI_API_BASE_URLS` e `OPENAI_API_KEYS`. `OPENAI_API_CONFIGS` imposta le opzioni di ogni connessione, come `model_ids`, indicizzate in base alla posizione della connessione in quell’elenco:

```bash
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
```

Il [riferimento alle variabili d’ambiente](https://docs.openwebui.com/reference/env-configuration) di Open WebUI le classifica come impostazioni ConfigVar. Vengono lette al primo avvio e salvate nel database. Da lì in poi vince il pannello di amministrazione. Modifica la connessione in **Settings > Connections** nella sezione di amministrazione, oppure imposta `ENABLE_PERSISTENT_CONFIG=False` se vuoi che l’ambiente venga applicato a ogni avvio.

## Quale modello scegliere

| Uso | Modello | Contesto |
| --- | --- | --- |
| Chat generica, strumenti, JSON | `broadnet/glm-5.3` | 1.048.576 |
| Domande sulle immagini, arabo | `broadnet/qwen3.8-27b` | 262.144 |
| Documenti lunghi, immagini | `broadnet/deepseek-v4.1-flash` | 1.048.576 |
| Costo basso, credito gratuito | `broadnet/gemma-4-26b-a4b` | 32.768 |

BroadNet ha testato Qwen3.8 27B in arabo, compresi i dialetti del Golfo ed egiziano; vedi [come scegliere un LLM per l’arabo](https://broadrouter.com/it/blog/choosing-an-llm-for-arabic/). Gemma 4 VL 26B è l’unico modello di chat che funziona con il credito iniziale di $5; il credito copre anche i due modelli Transcribe. I prezzi di ciascuno sono nella [pagina dei prezzi](https://broadrouter.com/it/pricing/).

Open WebUI passa i parametri standard come `temperature` e `max_tokens`, e supporta l’uso degli strumenti quando modello e server supportano `tools`. BroadNet indica gli strumenti per GLM 5.3 e Qwen3.8 27B.

## Risoluzione dei problemi

-   **Verify Connection fallisce con 400, 401 o 403.** Il pulsante di verifica di Open WebUI chiama `/models`. La sua documentazione dice che chat completions può comunque funzionare. Aggiungi gli ID alla allowlist e prova una chat. Se anche la chat restituisce 401, la chiave è sbagliata, scaduta o ha esaurito la quota a consumo.
-   **Il modello compare nell’elenco ma il primo messaggio fallisce.** Controlla che l’ID corrisponda esattamente a quello di BroadNet, con il prefisso `broadnet/`. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash richiedono una ricarica.
-   **Risposte vuote.** I modelli di ragionamento (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) spendono prima i token di output nel ragionamento. Se hai impostato **max\_tokens** negli **Advanced Params** del modello, alzalo o svuotalo. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **429 quando più persone chattano.** Una chiave a consumo consente 30 richieste al minuto e 4 in contemporanea. Open WebUI fa anche chiamate in background, per esempio per i titoli delle chat, con la stessa chiave. Vedi [errori e retry](https://broadrouter.com/it/guides/errors-and-retries/).
-   **Le variabili d’ambiente modificate non hanno effetto.** Il primo avvio ha salvato i vecchi valori. Modifica la connessione nel pannello di amministrazione, oppure vedi la sezione sulle variabili d’ambiente qui sopra.
-   **Usare una chiave di piano.** Una [sessione del piano illimitato](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/) esegue una richiesta alla volta, e le chiavi non si possono condividere. Va bene per l’istanza personale di una persona; le richieste degli altri utenti finiscono in coda.

## Termini in questa guida

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

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

[Tool calling (chiamata di strumenti)](https://broadrouter.com/it/glossary/tool-calling/)

Il tool calling, detto anche function calling, è una funzionalità delle API LLM in cui il modello restituisce una richiesta strutturata di eseguire una funzione definita dallo sviluppatore, con argomenti JSON. L’applicazione esegue la funzione e rimanda il risultato; il modello non esegue mai codice da solo.

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

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

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

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

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

## Domande frequenti

### Perché Verify Connection fallisce ma la chat funziona?

Il pulsante di verifica di Open WebUI chiama l’endpoint /models del provider. La sua documentazione dice che una verifica fallita non significa che la chat non funzioni. Aggiungi a mano gli ID dei modelli BroadNet alla allowlist Model IDs.

### Posso configurare la connessione con le variabili d’ambiente?

Sì. Imposta OPENAI\_API\_BASE\_URL su https://inference.broadnet.ai/v1 e OPENAI\_API\_KEY con la tua chiave BroadNet. Open WebUI le salva al primo avvio, quindi le modifiche successive alle variabili vengono ignorate, a meno che ENABLE\_PERSISTENT\_CONFIG sia False.

### Perché il nuovo valore di OPENAI\_API\_BASE\_URL non ha effetto?

Open WebUI lo tratta come ConfigVar. Dopo il primo avvio usa il valore salvato nel suo database. Cambia l’URL in Settings > Connections nella sezione di amministrazione, oppure imposta ENABLE\_PERSISTENT\_CONFIG=False per leggere l’ambiente a ogni avvio.

### Tutto il mio team può condividere una sola chiave del piano illimitato in Open WebUI?

No. I piani di BroadNet non consentono di condividere una chiave, e una sessione del piano esegue una richiesta alla volta. Per un Open WebUI condiviso usa una chiave a consumo.

## Guide correlate

-   [Aggiungere BroadNet Inference a LibreChat come custom endpoint](https://broadrouter.com/it/guides/librechat-custom-endpoint/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Come funzionano i piani API LLM illimitati per gli agenti](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/)
-   [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-open-webui-openai-api&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di Open WebUI, provider compatibili con OpenAI (verificata il 2026-11-16)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Documentazione di Open WebUI, configurazione con variabili d’ambiente (verificata il 2026-11-14)](https://docs.openwebui.com/reference/env-configuration)
-   [Riferimento API di BroadNet Inference (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-open-webui-openai-api&utm_content=sources)
