---
title: "LibreChat: custom endpoint in librechat.yaml (API OpenAI)"
description: "Aggiungi BroadNet Inference a LibreChat come custom endpoint compatibile OpenAI in librechat.yaml, con chiave nel .env, elenco dei modelli e title model."
url: https://broadrouter.com/it/guides/librechat-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/librechat-custom-endpoint/) (aggiornato il 2026-11-16).

# Aggiungere BroadNet Inference a LibreChat come custom endpoint

Aggiornato 2026-11-16

In librechat.yaml aggiungi sotto endpoints.custom una voce con name BroadNet, apiKey che rimanda a una variabile d’ambiente come BROADNET\_API\_KEY, baseURL https://inference.broadnet.ai/v1 e models.default con ID BroadNet come broadnet/glm-5.3. Metti la chiave nel .env, su Docker monta il file nel container e riavvia LibreChat. LibreChat aggiunge da solo /chat/completions al base URL.

LibreChat è un’app di chat open source che supporta i servizi compatibili con OpenAI come **custom endpoint**. Li definisci in `librechat.yaml`, tieni le chiavi nel `.env` e, su Docker, monti il file YAML nel container. BroadRouter è il sito di BroadNet; i passaggi seguono la [guida ai custom endpoint di LibreChat](https://www.librechat.ai/docs/quick_start/custom_endpoints).

## Configurazione

1.  **Monta librechat.yaml (solo Docker).** Copia `docker-compose.override.yml.example` in `docker-compose.override.yml` e verifica che il volume sia attivo:

```yaml
services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml
```

2.  **Aggiungi l’endpoint** a `librechat.yaml` nella root del progetto, sotto `endpoints.custom`:

```yaml
endpoints:
  custom:
    - name: 'BroadNet'
      apiKey: '${BROADNET_API_KEY}'
      baseURL: 'https://inference.broadnet.ai/v1'
      models:
        default:
          - 'broadnet/glm-5.3'
          - 'broadnet/qwen3.8-27b'
          - 'broadnet/deepseek-v4.1-flash'
          - 'broadnet/gemma-4-26b-a4b'
        fetch: false
      titleConvo: true
      titleModel: 'broadnet/gemma-4-26b-a4b'
      modelDisplayLabel: 'BroadNet'
```

Mantieni le chiavi di primo livello che il tuo file ha già, come `version`.

3.  **Imposta la chiave** nel `.env`:

```bash
BROADNET_API_KEY=your-broadnet-key
```

4.  **Riavvia LibreChat.** Con Docker: `docker compose down && docker compose up -d`. Per un’installazione locale, riavvia con `npm run backend`. A quel punto BroadNet compare nel selettore degli endpoint.

## Note sui campi

-   **baseURL.** LibreChat aggiunge da solo `/chat/completions`, quindi usa la root `/v1` indicata sopra. Non impostare `directEndpoint: true`; quell’opzione serve per un baseURL che è già l’URL completo delle completions.
-   **fetch: false.** È il default di LibreChat; lo impostiamo per rendere esplicita la scelta. La documentazione di BroadNet descrive `GET /v1/models` come metadati pubblici del catalogo per i sistemi di monitoraggio, quindi elencare i modelli in `default` è più prevedibile.
-   **titleModel.** LibreChat scrive un titolo per ogni chat con una richiesta in più. Un modello piccolo, economico e senza ragionamento mantiene breve quella chiamata. La documentazione di BroadNet non indica il ragionamento per Gemma 4 VL 26B.
-   **user\_provided.** Imposta `apiKey: 'user_provided'` se ogni utente deve inserire la propria chiave BroadNet nell’interfaccia. LibreChat conserva cifrata la chiave di ogni utente e la chiede la prima volta che l’utente sceglie l’endpoint.
-   **Nome univoco.** Un secondo endpoint con lo stesso nome, senza distinzione tra maiuscole e minuscole, sostituisce il primo senza avvisare. Se hai già una voce chiamata BroadNet, rinominane una.
-   **Niente chiavi in chiaro.** La documentazione di LibreChat consiglia il riferimento `${VAR}` invece di una chiave scritta in `librechat.yaml`, dove resterebbe nel file in chiaro.

## Quale modello scegliere

| Uso | Modello |
| --- | --- |
| Chat predefinita, strumenti, JSON | [GLM 5.3](https://broadrouter.com/it/models/glm-5.3/) |
| Immagini e arabo | [Qwen3.8 27B](https://broadrouter.com/it/models/qwen3.8-27b/) |
| Documenti lunghi, contesto da 1M | [DeepSeek V4.1 Flash](https://broadrouter.com/it/models/deepseek-v4.1-flash/) |
| Titoli e risposte rapide | [BroadNet Gemma 4 VL 26B](https://broadrouter.com/it/models/gemma-4-vl-26b/) |

Tra questi modelli, solo Gemma 4 VL 26B funziona con il credito iniziale di $5, che copre anche i due modelli Transcribe. Confronta i prezzi nella [pagina dei prezzi](https://broadrouter.com/it/pricing/).

## Risoluzione dei problemi

-   **L’endpoint non compare.** Controlla che `name`, `baseURL`, `apiKey` e `models.default` siano scritti correttamente e indentati dentro `endpoints.custom`. LibreChat scarta le voci incomplete senza righe di log. Su Docker verifica che il bind mount non sia commentato in `docker-compose.override.yml`.
-   **“Missing API Key for BroadNet”** (traduzione: chiave API mancante per BroadNet). `BROADNET_API_KEY` non è nel `.env`, oppure LibreChat non è stato riavviato. L’endpoint compare comunque; l’errore appare solo quando invii un messaggio.
-   **401 dal provider.** La chiave è sbagliata, scaduta, oppure la quota a consumo è esaurita.
-   **Errori sul modello.** Ogni ID deve corrispondere 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.** DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B ragionano prima di rispondere, e il ragionamento conta in `max_tokens`. Se nei parametri di LibreChat hai impostato un output massimo basso, alzalo. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **429 con molti utenti.** Una chiave a consumo consente 30 richieste al minuto e 4 contemporaneamente, condivise da tutti gli utenti dell’endpoint. Contano anche le richieste dei titoli. Le chiavi `user_provided` distribuiscono il carico. Vedi [errori e retry](https://broadrouter.com/it/guides/errors-and-retries/).
-   **Chiavi dei piani.** Una [sessione di un piano illimitato](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/) esegue una richiesta alla volta e non si può condividere, quindi non è adatta a un LibreChat multiutente.

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

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

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

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

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

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

## Domande frequenti

### Perché il mio endpoint BroadNet non compare in LibreChat?

LibreChat scarta un custom endpoint senza errori né righe di log se name, baseURL, apiKey o models.default mancano o sono scritti male. Su Docker controlla anche che librechat.yaml sia montato in /app/librechat.yaml e di aver riavviato.

### Ogni utente può usare la propria chiave BroadNet?

Sì. Imposta apiKey su user\_provided. LibreChat chiede la chiave a ogni utente la prima volta che sceglie l’endpoint e la conserva cifrata.

### Perché LibreChat mostra "Missing API Key for BroadNet"?

La variabile a cui rimanda apiKey non è impostata nel .env. L’endpoint compare comunque nel selettore, e l’errore appare solo quando invii un messaggio. Aggiungi la variabile e riavvia LibreChat.

### Il baseURL di LibreChat deve includere /chat/completions?

No. Per impostazione predefinita LibreChat aggiunge /chat/completions al baseURL. Usa https://inference.broadnet.ai/v1. Imposta directEndpoint su true solo se l’URL che inserisci è già l’endpoint completo delle completions.

## Guide correlate

-   [Collegare Open WebUI a BroadNet Inference](https://broadrouter.com/it/guides/open-webui-openai-api/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/)
-   [Limita le chiavi API ai tuoi server con le allowlist di IP](https://broadrouter.com/it/guides/api-keys-ip-allow-lists/)
-   [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-librechat-custom-endpoint&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di LibreChat, quick start dei Custom Endpoints (verificata il 2026-11-14)](https://www.librechat.ai/docs/quick_start/custom_endpoints)
-   [Documentazione di LibreChat, struttura dell’oggetto Custom Endpoint (verificata il 2026-11-14)](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint)
-   [Riferimento API di BroadNet Inference (verificato il 2026-11-16) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-librechat-custom-endpoint&utm_content=sources)
