BroadRouter
Inizia

Base URL delle API compatibili con OpenAI: 14 provider verificati

A cura del team di BroadNet Inference · 6 min di lettura · Pubblicato

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.

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

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

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.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity