---
title: "Cos’è un’API compatibile con OpenAI? Come funziona | BroadRouter"
description: "Un’API compatibile con OpenAI accetta le stesse richieste di OpenAI: gli SDK esistenti funzionano cambiando base URL, chiave e modello. Cosa coincide e cosa cambia."
url: https://broadrouter.com/it/glossary/openai-compatible-api/
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/openai-compatible-api/) (aggiornato il 2026-11-15).

# API compatibile con OpenAI

Aggiornato 2026-11-15

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.

Detto anche: API compatibile OpenAI, API in stile OpenAI, compatibilità con OpenAI, OpenAI-compatible API, OpenAI API compatible, OpenAI-style API, OpenAI drop-in replacement

Il formato dell’API di OpenAI è diventato la lingua comune degli strumenti per LLM. Oggi molti provider lo accettano, quindi una sola libreria client può parlare con tanti backend.

## Come funziona

Un’API compatibile copia le parti dell’API di OpenAI da cui dipendono i client:

-   gli stessi percorsi, come `/v1/chat/completions` e `/v1/audio/transcriptions`;
-   le stesse strutture JSON: un array `messages` in ingresso, `choices[0].message.content` in uscita e un blocco `usage` con i conteggi dei token;
-   una [chiave API](https://broadrouter.com/it/glossary/api-key/) inviata come `Authorization: Bearer <key>`;
-   lo [streaming](https://broadrouter.com/it/glossary/streaming/) come server-sent events quando `stream` è true.

Cambiare provider è una modifica di configurazione. Con l’SDK Python ufficiale:

```python
from openai import OpenAI
import os

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

Rispetto a un esempio di OpenAI sono cambiati solo tre valori: la [base URL](https://broadrouter.com/it/glossary/base-url/), la chiave e l’ID del modello.

## Perché è importante

La compatibilità abbassa il costo del cambio. SDK, framework per agenti, plugin per IDE e [router](https://broadrouter.com/it/glossary/llm-router/) che parlano il formato OpenAI funzionano senza codice nuovo. Puoi provare un secondo provider in pochi minuti e tenerti la possibilità di spostarti.

Ma compatibile non vuol dire identico. Il livello di compatibilità di Anthropic, per esempio, ignora `strict` sugli strumenti e lascia vuoto `prompt_tokens_details`. Le differenze tipiche sono:

-   parametri ignorati o rifiutati;
-   come i [token di ragionamento](https://broadrouter.com/it/glossary/reasoning-tokens/) contano in `max_tokens`;
-   se l’usage viene riportato alla fine di uno stream;
-   rate limit e codici di errore.

## Su BroadNet Inference

BroadNet Inference serve `POST /v1/chat/completions`, `POST /v1/audio/transcriptions` e `GET /v1/models` su `https://inference.broadnet.ai/v1`. Le chiavi si inviano solo come `Authorization: Bearer <key>`. Le guide per [Python](https://broadrouter.com/it/guides/openai-python-sdk/) e [Node](https://broadrouter.com/it/guides/openai-node-sdk/) mostrano configurazioni complete, e [LangChain](https://broadrouter.com/it/guides/langchain-openai-base-url/) funziona allo stesso modo.

Due differenze da mettere in conto: DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B ragionano prima di rispondere, e il ragionamento conta in `max_tokens`. Inoltre una chiave a consumo consente 30 richieste al minuto e 4 contemporanee. La [checklist di migrazione](https://broadrouter.com/it/blog/openai-compatible-api-migration-checklist/) copre il resto.

## Errori comuni

-   Lasciare un nome di modello OpenAI come `gpt-6-astra` (il modello di punta di OpenAI nella sua pagina dei modelli, verificata il 2026-11-15). Usa l’ID del modello del provider.
-   Dare per scontato che un parametro funzioni perché la richiesta è andata a buon fine. Alcuni provider ignorano in silenzio i campi sconosciuti.

## Domande frequenti

### Compatibile con OpenAI significa che funzionano tutte le funzionalità di OpenAI?

No. Significa che coincidono i formati principali di richiesta e risposta. Singoli campi possono essere ignorati o rifiutati. Il livello di compatibilità di Anthropic, per esempio, documenta i campi che ignora e quelli che restituiscono un errore 400. Leggi l’elenco del provider prima di contare su un parametro.

### Mi serve un SDK diverso?

No. Gli SDK ufficiali di OpenAI accettano una base URL personalizzata. In Python passa base\_url, in Node passa baseURL, oppure imposta la variabile d’ambiente OPENAI\_BASE\_URL.

### Quali endpoint supporta BroadNet Inference?

POST /v1/chat/completions per la chat e POST /v1/audio/transcriptions per lo speech-to-text. Esiste anche GET /v1/models, che la documentazione di BroadNet descrive come metadati pubblici del catalogo per i sistemi di monitoraggio esterni, quindi prendi gli ID dei modelli per le richieste dal riferimento API.

## Vedi anche

-   [Base URL (URL di base)](https://broadrouter.com/it/glossary/base-url/) (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)
-   [Streaming](https://broadrouter.com/it/glossary/streaming/) (termine)
-   [Provider di inferenza (inference provider)](https://broadrouter.com/it/glossary/inference-provider/) (termine)
-   [Server-sent events (SSE)](https://broadrouter.com/it/glossary/sse/) (termine)
-   [Chat Completions API](https://broadrouter.com/it/glossary/chat-completions-api/) (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)
-   [OpenRouter o piano flat per agenti AI: quale costa meno?](https://broadrouter.com/it/blog/openrouter-alternative-flat-rate/) (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-openai-compatible-api&utm_content=page-cta) ·

**Fonti**

-   [Riferimento API di OpenAI, creare una chat completion](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Anthropic, compatibilità con l’SDK di OpenAI e i suoi limiti](https://platform.claude.com/docs/en/api/openai-sdk)
-   [SDK Python di OpenAI (base\_url e OPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [Riferimento API di BroadNet Inference (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-openai-compatible-api&utm_content=sources)
-   [OpenAI, Models (verificata il 2026-11-15)](https://developers.openai.com/api/docs/models)
