---
title: "Cos’è la base URL di un’API LLM? Con esempi | BroadRouter"
description: "La base URL è l’indirizzo radice che un SDK mette davanti a ogni percorso dell’API. Come funziona nei client compatibili con OpenAI e gli errori che causano un 404."
url: https://broadrouter.com/it/glossary/base-url/
lang: it
updated: 2026-11-15
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/glossary/base-url/) (aggiornato il 2026-11-15).

# Base URL (URL di base)

Aggiornato 2026-11-15

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.

Detto anche: base URL, URL di base, URL base dell’API, base\_url, api\_base, baseURL, OPENAI\_BASE\_URL, API base URL, endpoint URL

Ogni richiesta che fa un SDK è la base URL più un percorso. Se la base URL è giusta, il resto del client funziona senza modifiche.

## Come funziona

Il client unisce due parti:

| Parte | Esempio |
| --- | --- |
| Base URL | `https://inference.broadnet.ai/v1` |
| Percorso dell’endpoint | `/chat/completions` |
| URL completo della richiesta | `https://inference.broadnet.ai/v1/chat/completions` |

Nel codice, il nome del parametro dipende dalla libreria:

```python
# Python SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
```

```js
// Node SDK
const client = new OpenAI({ baseURL: "https://inference.broadnet.ai/v1", apiKey: process.env.BROADNET_API_KEY });
```

Entrambi gli SDK ufficiali ripiegano sulla variabile d’ambiente `OPENAI_BASE_URL`, e sull’indirizzo di OpenAI quando non è impostato nulla. Altri strumenti usano nomi come `api_base` o `OPENAI_API_BASE`.

## Perché è importante

La base URL è ciò che rende un’[API compatibile con OpenAI](https://broadrouter.com/it/glossary/openai-compatible-api/) un cambio immediato. Decide anche dove vanno i tuoi prompt e chi ti fattura. Un valore sbagliato può mandare il traffico, e la tua [chiave API](https://broadrouter.com/it/glossary/api-key/), al provider sbagliato. Tienila nella configurazione accanto alla chiave, non scritta a mano in più punti del codice.

I router usano la stessa idea: punti la base URL verso il [router](https://broadrouter.com/it/glossary/llm-router/) invece che verso un provider di modelli.

## Su BroadNet Inference

La base URL è `https://inference.broadnet.ai/v1` per tutti i modelli: chat, vision e speech-to-text. La chat va a `/chat/completions` e la trascrizione a `/audio/transcriptions`. La [guida rapida con curl](https://broadrouter.com/it/guides/curl-quickstart/) mostra una prima richiesta, e la [guida a LangChain](https://broadrouter.com/it/guides/langchain-openai-base-url/) mostra dove si trova l’impostazione in un framework.

## Errori comuni

-   **Manca `/v1`.** `https://inference.broadnet.ai` senza `/v1` produce errori 404 dall’SDK.
-   **Percorso duplicato.** Incollare come base URL l’endpoint completo, come `.../v1/chat/completions`, fa chiamare all’SDK `.../chat/completions/chat/completions`.
-   **Variabili d’ambiente rimaste.** Una vecchia `OPENAI_BASE_URL` nella shell sovrascrive quello che ti aspetti. Stampala quando le richieste vanno nel posto sbagliato.
-   **HTTP semplice.** Usa sempre `https://`. Le chiavi bearer devono viaggiare su TLS.
-   **Cambiare l’URL ma non il modello.** Ogni provider ha i propri ID di modello, come `broadnet/deepseek-v4.1-flash`.

Devi spostare un’intera app? Segui la [checklist di migrazione](https://broadrouter.com/it/blog/openai-compatible-api-migration-checklist/).

## Domande frequenti

### La base URL deve terminare con /v1?

Per gli SDK compatibili con OpenAI sì, quando i percorsi del provider iniziano con /v1. L’SDK poi aggiunge percorsi come /chat/completions. Controlla il valore esatto nella documentazione del provider.

### Posso impostare la base URL senza toccare il codice?

Sì. Gli SDK ufficiali di OpenAI per Python e Node leggono la variabile d’ambiente OPENAI\_BASE\_URL quando non passi una base URL. Alcuni strumenti usano nomi di variabile propri, come OPENAI\_API\_BASE in Aider.

### Qual è la base URL di BroadNet Inference?

https://inference.broadnet.ai/v1

## Vedi anche

-   [API compatibile con OpenAI](https://broadrouter.com/it/glossary/openai-compatible-api/) (termine)
-   [Chiave API (API key)](https://broadrouter.com/it/glossary/api-key/) (termine)
-   [LLM router (router per LLM)](https://broadrouter.com/it/glossary/llm-router/) (termine)
-   [Usare l’SDK Python di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-python-sdk/) (guida)
-   [Usare l’SDK Node.js di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-node-sdk/) (guida)
-   [Usare LangChain con BroadNet Inference](https://broadrouter.com/it/guides/langchain-openai-base-url/) (guida)
-   [Prima richiesta a BroadNet Inference con curl](https://broadrouter.com/it/guides/curl-quickstart/) (guida)
-   [Passare a un’API compatibile con OpenAI: la checklist di migrazione](https://broadrouter.com/it/blog/openai-compatible-api-migration-checklist/) (articolo)

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-glossary-base-url&utm_content=page-cta) ·

**Fonti**

-   [README dell’SDK Python di OpenAI (base\_url e OPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [SDK Node di OpenAI (baseURL, con OPENAI\_BASE\_URL come predefinito)](https://github.com/openai/openai-node)
-   [Guida rapida di OpenRouter (esempio di base URL di terze parti)](https://openrouter.ai/docs/quickstart)
-   [Riferimento API di BroadNet Inference (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-base-url&utm_content=sources)
