Home / Guide / Base URL di API gratuite compatibili con OpenAI

Base URL di API gratuite compatibili con OpenAI

La maggior parte dei provider LLM gratuiti accetta il formato dell'API OpenAI. Nel tuo client cambi due valori: la Base URL e la chiave API. Questa pagina elenca la Base URL di ogni provider gratuito, verificata sulla documentazione del provider.

Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.

Base URL dei provider gratuiti

Verificato sulla documentazione dei provider
ProviderBase URL compatibile con OpenAIChiave
Google AI Studio (Gemini)https://generativelanguage.googleapis.com/v1beta/openai/Chiave API di Gemini
Groqhttps://api.groq.com/openai/v1Chiave API di Groq
OpenRouterhttps://openrouter.ai/api/v1Chiave di OpenRouter. Usa ID di modello che terminano con :free.
NVIDIA API Cataloghttps://integrate.api.nvidia.com/v1Chiave API di NVIDIA
Cloudflare Workers AIhttps://api.cloudflare.com/client/v4/accounts/<account-id>/ai/v1Token API di Cloudflare
Coherehttps://api.cohere.ai/compatibility/v1Chiave di prova o di produzione di Cohere
Z.ai (Zhipu)https://api.z.ai/api/paas/v4/Chiave API di Z.ai
OVHcloud AI Endpointshttps://oai.endpoints.kepler.ai.cloud.ovh.net/v1Facoltativa. L'uso anonimo è consentito con un limite basso.
Kilo Gatewayhttps://ai-gateway.kilo.ai/api/v1Facoltativa per i modelli gratuiti
AI Hordehttps://oai.aihorde.net/v1Chiave Horde, oppure la chiave anonima 0000000000
Mistralhttps://api.mistral.ai/v1Chiave di Mistral. L'API richiede l'attivazione della fatturazione.
Scaleway Generative APIshttps://api.scaleway.ai/v1Chiave segreta di Scaleway
Nota: alcuni SDK aggiungono /chat/completions alla Base URL. Non inserire tu /chat/completions nella Base URL. Mantieni il percorso finale esattamente come mostrato.

Come cambiare la Base URL nel tuo client

Gli SDK di OpenAI leggono la Base URL da un parametro o da una variabile d'ambiente. Questo esempio usa Groq. Cambia l'URL, la chiave e l'ID del modello per un altro provider.

Python (SDK di OpenAI)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.groq.com/openai/v1",
    api_key="<groq-key>",
)
resp = client.chat.completions.create(
    model="openai/gpt-oss-20b",
    messages=[{"role": "user", "content": "Say hello"}],
)
print(resp.choices[0].message.content)

Variabili d'ambiente

export OPENAI_BASE_URL=https://api.groq.com/openai/v1
export OPENAI_API_KEY=<groq-key>

Molti strumenti, per esempio Open WebUI, Cline e Aider, hanno un campo per una Base URL compatibile con OpenAI. Inserisci in quel campo l'URL della tabella.

Verifica una Base URL prima di usarla

Esegui due controlli prima di configurare uno strumento. Primo, elenca i modelli. Questo controllo mostra che l'URL e la chiave sono corretti. Secondo, invia una breve richiesta di chat. Questo controllo mostra che l'ID del modello è valido e che hai quota disponibile.

Controlla l'URL, la chiave e un modello

BASE=https://api.groq.com/openai/v1
KEY=<groq-key>

# 1. List the models
curl -s $BASE/models -H "Authorization: Bearer $KEY" | head -c 600

# 2. Send one short request
curl -s $BASE/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-oss-20b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 200}'

Non impostare un max_tokens molto basso sui modelli di ragionamento. Alcuni modelli gratuiti usano token di ragionamento nascosti prima della risposta visibile. Con un limite basso, la risposta può fermarsi con una risposta vuota.

Se il primo controllo restituisce 401, la chiave non è valida per questo URL. Se il secondo controllo restituisce 429, l'URL e la chiave sono corretti, ma il limite gratuito è stato raggiunto. Leggi gli header dei limiti di frequenza del provider per trovare l'ora del ripristino.

Differenze di compatibilità da conoscere

«Compatibile con OpenAI» non significa che ogni parametro funzioni. Ogni provider supporta un sottoinsieme diverso.

  • Groq: le richieste con logprobs, logit_bias, top_logprobs, messages[].name o n diverso da 1 restituiscono l'errore 400. Una temperature di 0 diventa 1e-8.
  • Cloudflare: l'URL contiene il tuo ID account. Il token viene inviato come token Bearer.
  • AI Horde: l'endpoint supporta /v1/chat/completions e /v1/models. I modelli sono eseguiti da volontari, quindi velocità ed elenco dei modelli cambiano.
  • ID dei modelli: ogni provider usa i propri nomi di modello. Leggi GET /v1/models su ogni Base URL per ottenere ID validi.

Modelli gratuiti che puoi chiamare oggi

Questi modelli gratuiti supportano il tool calling e hanno una finestra di contesto di almeno 128K token. La tabella mostra i provider che offrono ogni modello gratuitamente.

Modelli gratuiti con tool calling e contesto da 128K o più
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3 FlashNVIDIA NIM1M40 richieste/min
40 RPM
SìNo
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSìSì
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìSì
Qwen3.8 27BGroq, OVH AI Endpoints262K30 richieste/min
250 richieste/giorno
70,000 token/min
~6M
SìSì
Gemini 3.6 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/daySìSì
Gemini 3.5 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Nemotron 3 Ultra 550BKilo Gateway, NVIDIA NIM, OpenRouter1M20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìNo
Gemini 3.5 Flash LiteGoogle AI Studio1M15 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Qwen3.6 27BOVH AI Endpoints131K2 richieste/min
2/min per IP
SìNo
Muse Glimmer 30BNVIDIA NIM131K40 richieste/min
40 RPM
SìSì

Mostrati 12 di 46 modelli gratuiti corrispondenti. Vedi tutti i modelli.

Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.

Una sola Base URL per ogni provider gratuito

Ogni Base URL della tabella ha una propria chiave e un proprio limite di frequenza. Quando un provider invia un errore 429, il tuo codice deve passare a un altro URL. FreeLLMAPI ti dà invece una sola Base URL compatibile con OpenAI. Gira sul tuo computer e invia ogni richiesta a un provider gratuito che ha ancora quota disponibile.

Installa e chiama la Base URL locale

curl -fsSL https://freellmapi.co/install.sh | bash

export OPENAI_BASE_URL=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>

curl $OPENAI_BASE_URL/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'
  • Aggiungi le chiavi dei tuoi provider nella pagina Keys su http://localhost:3001.
  • Usa auto per lasciare scegliere il router. Usa auto:fast o auto:smart per dare la preferenza a velocità o intelligenza. Puoi anche inviare un ID di modello.
  • L'header di risposta X-Routed-Via mostra il provider e il modello che hanno risposto.
  • Lo stesso server ha anche /v1/messages per i client Anthropic e /v1beta per Gemini CLI.

FreeLLMAPI usa i piani gratuiti, quindi valgono ancora i limiti di frequenza di ogni provider. Il failover distribuisce il carico tra i provider, ma non elimina i limiti.

Risoluzione dei problemi

ProblemaCausaSoluzione
404 Not FoundLa Base URL ha un percorso sbagliato, oppure contiene /chat/completionsUsa la Base URL della tabella esattamente com'è
401 UnauthorizedLa chiave appartiene a un altro providerUsa la chiave dello stesso provider della Base URL
400 su una richiesta validaIl provider non supporta un parametroRimuovi parametri come logprobs o n
Modello non trovatoL'ID del modello appartiene a un altro providerChiama GET /v1/models sulla Base URL
429 Too Many RequestsIl limite gratuito è stato raggiuntoAspetta il ripristino, oppure usa un gateway che passa al provider successivo
Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

Domande frequenti

Qual è la Base URL compatibile con OpenAI per Gemini?

Google documenta https://generativelanguage.googleapis.com/v1beta/openai/ come Base URL. Usa come chiave API la tua chiave Gemini di AI Studio.

Qual è la Base URL OpenAI di Groq?

Groq documenta https://api.groq.com/openai/v1. Usa una chiave API di Groq e un ID di modello di Groq.

Esiste un'API gratuita compatibile con OpenAI senza chiave?

Sì, con limiti bassi. OVHcloud AI Endpoints consente 2 richieste anonime al minuto per ogni IP e modello. Kilo Gateway consente 200 richieste anonime all'ora verso modelli gratuiti.

Posso usare l'SDK Python di OpenAI con i provider gratuiti?

Sì. Imposta base_url sull'URL del provider e api_key sulla chiave del provider. Usa un ID di modello di quel provider.

Come uso molti provider gratuiti con una sola Base URL?

Esegui sul tuo computer un gateway come FreeLLMAPI. Punta il tuo client a http://localhost:3001/v1 con una sola chiave unificata, e il router sceglie un provider per ogni richiesta.

Guide correlate

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti