---
title: "Base URL delle API compatibili con OpenAI: 14 provider"
description: "La base_url di 14 API LLM compatibili con OpenAI, presa dalla documentazione di ogni provider, con gli endpoint elencati e le differenze che bloccano il cambio."
url: https://broadrouter.com/it/blog/openai-compatible-api-base-urls/
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/blog/openai-compatible-api-base-urls/) (aggiornato il 2026-11-15).

# Base URL delle API compatibili con OpenAI: 14 provider verificati

A cura del team di BroadNet Inference · 6 min di lettura · Pubblicato 2026-11-15

Un’API compatibile con OpenAI ti permette di tenere l’SDK di OpenAI cambiando solo due cose: base\_url e chiave API. La base URL varia da provider a provider: per esempio https://api.groq.com/openai/v1 per Groq, https://openrouter.ai/api/v1 per OpenRouter e https://inference.broadnet.ai/v1 per BroadNet Inference. Percorsi, ID dei modelli e parametri supportati restano diversi, quindi prova una richiesta prima di cambiare.

## Punti chiave

-   Quasi tutti i provider chiudono la base URL con /v1, ma non tutti: DeepSeek non usa un percorso di versione, Z.ai usa /api/paas/v4/ e Gemini /v1beta/openai/.
-   Imposta base\_url sulla radice a cui l’SDK aggiunge /chat/completions. Non incollare mai il percorso completo /chat/completions in base\_url.
-   «Compatibile» raramente vuol dire tutti gli endpoint. Verifica quali tra chat completions, trascrizioni audio, embedding e Responses API documenta ciascun provider.
-   Gli ID dei modelli cambiano con il provider: deepseek-ai/DeepSeek-V4-Flash-0731 su DeepInfra, accounts/fireworks/models/… su Fireworks, broadnet/… su BroadNet.
-   Anthropic dice che il suo livello OpenAI serve soprattutto per i test; xAI indica la Responses API come via preferita. Usa le API native dove il provider lo dice.

**In questa pagina**

1.  Qual è la base URL di ogni provider compatibile con OpenAI?
2.  Come imposti la base URL nel codice?
3.  Come provi una nuova base URL con curl?
4.  Quali sono gli errori più comuni quando cambi base\_url?
5.  Quali endpoint supporta BroadNet Inference?
6.  Conviene instradare più provider attraverso una sola base URL?
7.  Dove si colloca BroadNet Inference

Un’API compatibile con OpenAI accetta richieste con la stessa struttura dell’API di OpenAI, quindi gli SDK ufficiali di OpenAI funzionano dopo aver cambiato `base_url` e chiave API. La parte difficile è che ogni provider mette il proprio endpoint in un posto leggermente diverso. La tabella qui sotto ne elenca 14, ciascuno letto dalla documentazione del provider il 15 novembre 2026.

## Qual è la base URL di ogni provider compatibile con OpenAI?

| Provider | Base URL | Cosa elenca la sua documentazione sulla compatibilità OpenAI | Particolarità dichiarate nella documentazione |
| --- | --- | --- | --- |
| OpenAI | `https://api.openai.com/v1` | Tutto: è il riferimento | Valore predefinito dell’SDK se non imposti nulla |
| Anthropic | `https://api.anthropic.com/v1/` | Chat completions | “Primarily intended to test and compare model capabilities” (traduzione: pensato principalmente per testare e confrontare le capacità dei modelli); `strict` ignorato; input audio e file restituiscono 400 |
| Google Gemini | `https://generativelanguage.googleapis.com/v1beta/openai/` | Chat completions, embedding, generazione di immagini, models, batch | Supporto della libreria OpenAI “still in beta” (traduzione: ancora in beta); Responses API non elencata |
| DeepSeek | `https://api.deepseek.com` | Chat completions | Nessun percorso di versione; URL separata in formato Anthropic su `/anthropic` |
| Groq | `https://api.groq.com/openai/v1` | Chat completions, Responses API; note sulla trascrizione audio | `logprobs`, `logit_bias`, `top_logprobs`, `messages[].name` restituiscono 400; `n` deve essere 1; niente trascrizioni `srt` o `vtt` |
| Together AI | `https://api.together.ai/v1` | Chat, completions, immagini, sintesi vocale, trascrizioni, models, Responses | Inferenza solo negli USA su `https://us-api.together.ai/v1`; embedding solo su endpoint dedicati |
| Fireworks AI | `https://api.fireworks.ai/inference/v1` | Chat completions | ID dei modelli come `accounts/fireworks/models/…`; riduce `max_tokens` per stare nel contesto invece di dare errore, salvo indicazione contraria |
| DeepInfra | `https://api.deepinfra.com/v1/openai` | Chat completions; i client Responses usano la stessa base | Embedding, immagini e sintesi vocale documentati in una pagina a parte |
| Mistral AI | `https://api.mistral.ai/v1` | `POST /v1/chat/completions` | Il suo riferimento API non si definisce compatibile con OpenAI; provalo prima di farci affidamento |
| OpenRouter | `https://openrouter.ai/api/v1` | Chat completions | Header opzionali `HTTP-Referer` e `X-OpenRouter-Title` per le sue classifiche |
| xAI | `https://api.x.ai/v1` | Responses API | La sua guida dice “The Responses API is the preferred way of interacting with our models” (traduzione: la Responses API è il modo preferito di interagire con i nostri modelli) |
| Z.ai (GLM) | `https://api.z.ai/api/paas/v4/` | Chat completions | Percorso `v4`, non `v1` |
| Alibaba Model Studio | `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` (Singapore) | Chat completions | ID del workspace nell’host; una chiave funziona solo nella regione in cui è stata creata, altrimenti 401 |
| BroadNet Inference | `https://inference.broadnet.ai/v1` | Chat completions, trascrizioni audio | Gli ID dei modelli iniziano con `broadnet/`; vedi sotto |

Alibaba elenca anche un endpoint USA (Virginia) su `us-east-1`. La riga di Pechino nella stessa pagina mostra l’host di Singapore, mentre altre parti della pagina citano `cn-beijing`: conferma l’endpoint per la Cina nella console. La tabella è un’istantanea. Gli endpoint si spostano: durante la verifica, sia la documentazione di Anthropic sia quella di Google hanno fatto redirect a nuovi indirizzi.

Per i prezzi di questi provider, consulta le pagine dei [prezzi delle API LLM per provider](https://broadrouter.com/llm-api-pricing/providers/).

## Come imposti la base URL nel codice?

In Python, passa `base_url` al client:

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
r = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Say hello in one line."}],
)
print(r.choices[0].message.content)
```

In Node, l’opzione si chiama `baseURL`:

```js
import OpenAI from "openai";

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

Oppure impostala una volta sola per tutti gli strumenti che usano gli SDK ufficiali. Nel sorgente dell’SDK Node, `baseURL` prende come valore predefinito `process.env['OPENAI_BASE_URL']` e, in mancanza, `https://api.openai.com/v1`; il README di Python documenta la stessa variabile:

```bash
export OPENAI_BASE_URL="https://inference.broadnet.ai/v1"
export OPENAI_API_KEY="your-key"
```

Guide complete: [SDK Python di OpenAI](https://broadrouter.com/it/guides/openai-python-sdk/), [SDK Node di OpenAI](https://broadrouter.com/it/guides/openai-node-sdk/). Per capire cos’è una [base URL](https://broadrouter.com/it/glossary/base-url/) e perché gli strumenti la chiedono, vedi il glossario.

## Come provi una nuova base URL con curl?

Invia una sola richiesta minima prima di toccare il codice dell’applicazione:

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "broadnet/gemma-4-26b-a4b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 20}'
```

Sostituisci base URL, chiave e modello con quelli del provider che stai provando. Un 200 con un array `choices` vuol dire che percorso, chiave e ID del modello sono giusti. Un 404 di solito indica un percorso sbagliato; un 401 una chiave o una regione sbagliata; un 400 spesso nomina il parametro che il provider rifiuta. La [guida rapida a curl](https://broadrouter.com/it/guides/curl-quickstart/) ha altri esempi, e il [generatore di richieste API](https://broadrouter.com/tools/api-request-builder/) scrive per te le versioni curl, Python e Node.

## Quali sono gli errori più comuni quando cambi base\_url?

-   **Incollare l’endpoint completo.** L’SDK aggiunge `/chat/completions`. Una base URL che finisce già così produce `/chat/completions/chat/completions` e un 404.
-   **Aggiungere o togliere `/v1` per abitudine.** La base documentata di DeepSeek non ha `/v1`, quella di Z.ai finisce con `/v4/` e quella di Gemini con `/v1beta/openai/`. Copia la stringa esatta del provider.
-   **Tenere i nomi dei modelli di OpenAI.** I nomi `gpt-…` altrove non funzionano. Ogni provider ha il suo formato: `deepseek-ai/DeepSeek-V4-Flash-0731` su DeepInfra, `accounts/fireworks/models/…` su Fireworks, `broadnet/deepseek-v4.1-flash` su BroadNet.
-   **Inviare parametri che il provider rifiuta o ignora.** Groq restituisce 400 per `logprobs`; il livello di Anthropic ignora in silenzio `seed`, `logit_bias` e `reasoning_effort`. Un parametro ignorato in silenzio è peggio di un errore, perché niente te lo segnala.
-   **Dare per scontati gli stessi campi nella risposta.** Il livello di Anthropic restituisce `prompt_tokens_details` vuoto, quindi manca il conteggio dei token in cache. Fireworks mette l’usage dello streaming nell’ultimo chunk, che i tipi dell’SDK potrebbero non dichiarare.
-   **Dare per scontato che esista ogni endpoint.** «Compatibile con OpenAI» di solito vuol dire chat completions. Embedding, audio, generazione di immagini e Responses API sono questioni separate, come mostra la tabella.
-   **Mescolare le regioni.** Le chiavi Alibaba sono legate a una regione, e Together offre un host separato solo USA. Una chiave valida sull’host sbagliato fallisce comunque.

L’elenco completo da verificare prima del cambio è nella [checklist di migrazione verso API compatibili con OpenAI](https://broadrouter.com/it/blog/openai-compatible-api-migration-checklist/).

## Quali endpoint supporta BroadNet Inference?

Il [riferimento API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-blog-openai-compatible-api-base-urls&utm_content=body) di BroadNet documenta due endpoint di modello su `https://inference.broadnet.ai/v1`, più `GET /v1/models` per i metadati del catalogo:

| Endpoint | Modelli |
| --- | --- |
| `POST /v1/chat/completions` | DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B, BroadNet Gemma 4 VL 26B |
| `POST /v1/audio/transcriptions` | BroadNet Transcribe Arabic, BroadNet Transcribe (14 lingue) |

In pratica:

-   **Niente embedding, generazione di immagini o Responses API** nella documentazione. Uno strumento che ne richiede uno ha bisogno di un secondo provider per quella parte.
-   **Tool calling e output strutturato** sono documentati per [GLM 5.3](https://broadrouter.com/it/models/glm-5.3/) e [Qwen3.8 27B](https://broadrouter.com/it/models/qwen3.8-27b/).
-   **Le immagini entrano come URL `data:`** dentro parti di contenuto `image_url`, su DeepSeek V4.1 Flash, Qwen3.8 27B e Gemma 4 VL 26B.
-   **I modelli di ragionamento** (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) contano il ragionamento in `max_tokens`. Lascia almeno 1.000 token, oppure imposta `reasoning_effort` su `low`, come consiglia la documentazione; vedi [perché i modelli di ragionamento restituiscono risposte vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **Un elenco di modelli ha risposto** quando abbiamo chiamato `GET /v1/models` il 15 novembre 2026, ma non è nell’elenco degli endpoint documentati, quindi non costruirci sopra.
-   **I limiti** sulle chiavi a consumo sono 30 richieste al minuto e 4 in corso contemporaneamente.

Prezzi per 1M di token: DeepSeek V4.1 Flash $0.175 in input e $0.52 in output, Gemma 4 VL 26B $0.10 e $0.22. DeepSeek V4.1 Flash è venduto anche come piano flat a $60 al mese per sessione, una richiesta alla volta.

## Conviene instradare più provider attraverso una sola base URL?

Se la tua app chiama più di questi provider, un proxy come LiteLLM dà al tuo codice una sola base URL e mappa i nomi dei modelli su ciascun upstream. La mappatura la scegli tu; nessuno cambia provider al posto tuo, a meno che tu non configuri i fallback. [Failover delle API LLM](https://broadrouter.com/it/blog/llm-api-failover-fallback/) mostra come farlo, nel client o in LiteLLM. La [guida al proxy LiteLLM](https://broadrouter.com/it/guides/litellm-proxy-custom-provider/) mostra una voce per BroadNet. Per il significato del termine, vedi [API compatibile con OpenAI](https://broadrouter.com/it/glossary/openai-compatible-api/).

## Dove si colloca BroadNet Inference

BroadNet è una buona scelta se il tuo codice usa già le chat completions e vuoi modelli open, speech-to-text in arabo e multilingue, o una sessione DeepSeek a prezzo fisso su un’unica chiave. Non lo è se ti servono embedding, la Responses API o la generazione di immagini dallo stesso provider; Together AI e Gemini documentano una parte più ampia della superficie di OpenAI. Confronta la nostra tabella con la documentazione di ciascun provider prima di andare in produzione, perché queste URL e questi elenchi di endpoint cambiano.

Strumenti gratuiti sul tema (in inglese)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Strumenti gratuiti (in inglese)](https://broadrouter.com/tools/)

## Termini in questo articolo

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

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

[Embedding (embeddings)](https://broadrouter.com/it/glossary/embeddings/)

Gli embedding sono liste di numeri in virgola mobile (vettori) che un modello produce per rappresentare un testo, un’immagine o un altro input. Input con significato simile ottengono vettori vicini tra loro, quindi la distanza tra vettori serve a ordinare i risultati di ricerca, raggruppare documenti o trovare elementi correlati.

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

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

[Speech-to-text (riconoscimento vocale)](https://broadrouter.com/it/glossary/speech-to-text/)

Lo speech-to-text, detto anche riconoscimento automatico del parlato (ASR), è la tecnologia che converte l’audio parlato in testo scritto. Un’API speech-to-text riceve un file o uno stream audio e restituisce una trascrizione, di solito a prezzo per minuto di audio. L’accuratezza si misura con il word error rate e varia con accento, dialetto e qualità della registrazione.

[API compatibile con OpenAI](https://broadrouter.com/it/glossary/openai-compatible-api/)

Un’API compatibile con OpenAI è un’API HTTP che accetta gli stessi formati di richiesta e di risposta dell’API di OpenAI, come POST /v1/chat/completions, così SDK e strumenti di OpenAI possono usarla cambiando solo base URL, chiave API e nome del modello.

## Domande frequenti

### Qual è la base URL dell’API di OpenAI?

https://api.openai.com/v1. L’SDK Node ufficiale la usa quando non imposti né baseURL né la variabile d’ambiente OPENAI\_BASE\_URL.

### base\_url deve finire con /v1 o con /chat/completions?

Deve finire dove la fa finire la documentazione del provider, di solito /v1. L’SDK aggiunge da solo /chat/completions, quindi una base URL che finisce già con /chat/completions produce un 404.

### Posso impostare la base URL con una variabile d’ambiente?

Sì. Entrambi gli SDK ufficiali di OpenAI leggono OPENAI\_BASE\_URL, e lo fanno anche molti strumenti costruiti su di essi. Imposta accanto OPENAI\_API\_KEY e controlla la documentazione di ogni strumento, perché alcuni usano nomi di variabile propri.

### L’API di Claude è compatibile con OpenAI?

In parte. Anthropic offre https://api.anthropic.com/v1/ per l’SDK di OpenAI, ma dice che questo livello serve soprattutto per testare e confrontare i modelli, non come soluzione di produzione a lungo termine. Ignora strict sugli strumenti e rifiuta input audio e file.

### Quali endpoint supporta BroadNet Inference?

La sua documentazione elenca POST /v1/chat/completions e POST /v1/audio/transcriptions. Non elenca embedding, generazione di immagini né la Responses API.

### Perché la mia richiesta funziona con OpenAI ma fallisce con un altro provider?

Di solito per un ID del modello nel formato sbagliato o per un parametro che il provider rifiuta. Groq, per esempio, restituisce 400 per logprobs, logit\_bias, top\_logprobs e messages\[\].name. Togli i parametri opzionali e riprova con l’ID del modello esatto del provider.

## Continua a leggere

-   [Passare a un’API compatibile con OpenAI: la checklist di migrazione](https://broadrouter.com/it/blog/openai-compatible-api-migration-checklist/)
-   [Come scegliere un provider di API LLM: checklist in 20 punti](https://broadrouter.com/it/blog/choose-llm-api-provider-checklist/)
-   [Come valutare un LLM prima di cambiare provider](https://broadrouter.com/it/blog/evaluate-llm-before-switching/)
-   [Streaming degli LLM spiegato: chunk SSE, delta, usage e annullamento](https://broadrouter.com/it/blog/llm-streaming-sse-explained/)
-   [Hardware GPU e serving di BroadNet, come li descrive BroadNet](https://broadrouter.com/it/blog/broadnet-gpu-fleet-and-serving/)
-   [Cache delle risposte delle API LLM: una cache esatta in Python](https://broadrouter.com/it/blog/cache-llm-responses-cut-cost/)
-   [Guida: 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: Prima richiesta a BroadNet Inference con curl](https://broadrouter.com/it/guides/curl-quickstart/)
-   [Guida: Instradare LiteLLM verso BroadNet Inference (SDK e proxy)](https://broadrouter.com/it/guides/litellm-proxy-custom-provider/)

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-blog-openai-compatible-api-base-urls&utm_content=page-cta) ·

**Fonti**

-   [Sorgente dell’SDK Node di OpenAI, client.ts: base URL predefinita e OPENAI\_BASE\_URL (verificato il 2026-11-15)](https://github.com/openai/openai-node/blob/master/src/client.ts)
-   [README dell’SDK Python di OpenAI: base\_url e OPENAI\_BASE\_URL (verificato il 2026-11-15)](https://github.com/openai/openai-python)
-   [Anthropic, compatibilità con l’SDK di OpenAI (verificato il 2026-11-15)](https://platform.claude.com/docs/en/api/openai-sdk)
-   [Google, compatibilità di Gemini con OpenAI (verificato il 2026-11-15)](https://aistudio.google.com/docs/openai)
-   [Documentazione API di DeepSeek, prima chiamata API (verificato il 2026-11-15)](https://api-docs.deepseek.com/)
-   [Groq, compatibilità con OpenAI (verificato il 2026-11-15)](https://console.groq.com/docs/openai)
-   [Together AI, compatibilità con l’API di OpenAI (verificato il 2026-11-15)](https://docs.together.ai/docs/openai-api-compatibility)
-   [Fireworks AI, compatibilità con OpenAI (verificato il 2026-11-15)](https://docs.fireworks.ai/tools-sdks/openai-compatibility)
-   [DeepInfra, panoramica delle chat completions (verificato il 2026-11-15)](https://docs.deepinfra.com/chat/overview)
-   [Riferimento API di Mistral AI (verificato il 2026-11-15)](https://docs.mistral.ai/api/)
-   [Guida rapida di OpenRouter (verificato il 2026-11-15)](https://openrouter.ai/docs/quickstart)
-   [Riferimento API e guida alla chat di xAI (verificato il 2026-11-15)](https://docs.x.ai/docs/guides/chat)
-   [Z.ai, guida all’SDK Python di OpenAI (verificato il 2026-11-15)](https://docs.z.ai/guides/develop/openai/python)
-   [Alibaba Cloud Model Studio, compatibilità con OpenAI (verificato il 2026-11-15)](https://www.alibabacloud.com/help/en/model-studio/compatibility-of-openai-with-dashscope)
-   [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-blog-openai-compatible-api-base-urls&utm_content=sources)
