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.
Come imposti la base URL nel codice?
In Python, passa base_url al client:
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:
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:
export OPENAI_BASE_URL="https://inference.broadnet.ai/v1"
export OPENAI_API_KEY="your-key"
Guide complete: SDK Python di OpenAI, SDK Node di OpenAI. Per capire cos’è una 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:
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 ha altri esempi, e il generatore di richieste API 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/completionse un 404. - Aggiungere o togliere
/v1per 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-0731su DeepInfra,accounts/fireworks/models/…su Fireworks,broadnet/deepseek-v4.1-flashsu BroadNet. - Inviare parametri che il provider rifiuta o ignora. Groq restituisce 400 per
logprobs; il livello di Anthropic ignora in silenzioseed,logit_biasereasoning_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_detailsvuoto, 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.
Quali endpoint supporta BroadNet Inference?
Il riferimento API 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 e Qwen3.8 27B.
- Le immagini entrano come URL
data:dentro parti di contenutoimage_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 impostareasoning_effortsulow, come consiglia la documentazione; vedi perché i modelli di ragionamento restituiscono risposte vuote. - Un elenco di modelli ha risposto quando abbiamo chiamato
GET /v1/modelsil 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 mostra come farlo, nel client o in LiteLLM. La guida al proxy LiteLLM mostra una voce per BroadNet. Per il significato del termine, vedi API compatibile con OpenAI.
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.
