Home / Guide / API LLM gratuita per Open WebUI

API LLM gratuita per Open WebUI

Open WebUI è un'interfaccia di chat self-hosted. Si collega a qualsiasi server che usa l'API OpenAI Chat Completions. Questa guida collega Open WebUI a FreeLLMAPI, che riunisce 45 piani gratuiti dei provider dietro una sola chiave. Aggiungi una sola connessione. Il router invia ogni chat a un modello gratuito e passa al provider successivo quando un limite blocca una richiesta.

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

Come funziona la connessione

Open WebUI invia le richieste di chat all'URL di ogni connessione OpenAI. FreeLLMAPI resta in ascolto su http://localhost:3001/v1 e accetta le stesse richieste. Sceglie un modello gratuito, invia la richiesta e restituisce la risposta in formato OpenAI.

  • Una connessione, più provider: aggiungi un URL e una chiave unificata. Le chiavi dei provider restano in FreeLLMAPI, sul tuo computer.
  • Failover: quando un provider restituisce un errore 429, il router prova il modello successivo nella tua catena di fallback.
  • Limiti: i piani gratuiti hanno limiti di richieste e di token. Più chiavi di provider danno più richieste al giorno. Il failover distribuisce il carico, ma non elimina i limiti.

Installa prima FreeLLMAPI. Funziona in Docker. Apri la dashboard su http://localhost:3001, aggiungi almeno due chiavi di provider gratuiti nella pagina Keys e copia la tua chiave unificata.

Installa FreeLLMAPI (macOS o Linux)

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

Passo 1: trova l'URL corretto

L'URL che Open WebUI deve usare dipende da dove viene eseguito ciascun programma. Open WebUI di solito gira in Docker. Dentro un container, localhost indica il container stesso, non il tuo computer.

Open WebUI giraFreeLLMAPI giraURL da usare
Sull'host (pip o uv)Sull'host (Docker o app desktop)http://localhost:3001/v1
In Docker Desktop (macOS, Windows)Sull'hosthttp://host.docker.internal:3001/v1
In Docker su LinuxIn Docker (script di installazione)http://freellmapi:3001/v1 su una rete Docker condivisa
Su un altro computerSu un server nella tua LANhttp://<server-ip>:3001/v1, con HOST_BIND=0.0.0.0 solo su una rete fidata

Per impostazione predefinita, il container di FreeLLMAPI pubblica la sua porta solo su 127.0.0.1. Su Linux, un secondo container non sempre riesce a raggiungere quella porta tramite l'host. Collega entrambi i container a una stessa rete Docker. Poi usa il nome del servizio freellmapi come nome host.

Collega Open WebUI alla rete di FreeLLMAPI (Linux)

# Find the network of the FreeLLMAPI stack (usually freellmapi_default)
docker network ls

# Attach the Open WebUI container to it
docker network connect freellmapi_default open-webui

# Test the URL from inside the Open WebUI container
docker exec open-webui curl -s http://freellmapi:3001/v1/models \
  -H "Authorization: Bearer <unified-key>" | head -c 300

Passo 2: aggiungi la connessione

Puoi aggiungere la connessione nell'interfaccia o con le variabili d'ambiente. L'interfaccia è il metodo più semplice.

  1. Apri l'Admin Panel e vai su Settings > Connections.
  2. Trova l'elenco Manage OpenAI API Connections. Clicca su Add Connection.
  3. In URL, scrivi l'URL del passo 1, per esempio http://host.docker.internal:3001/v1.
  4. In API Key, incolla la tua chiave unificata di FreeLLMAPI.
  5. Clicca su Verify Connection. Poi clicca su Save.

Per impostare la connessione all'avvio del container, usa OPENAI_API_BASE_URL e OPENAI_API_KEY. Il comando seguente è il normale comando docker run di Open WebUI con queste due variabili aggiunte.

docker run con la connessione di FreeLLMAPI

docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -e OPENAI_API_BASE_URL=http://host.docker.internal:3001/v1 \
  -e OPENAI_API_KEY=<unified-key> \
  -v open-webui:/app/backend/data \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

Per mantenere una connessione OpenAI esistente, usa le variabili al plurale. OPENAI_API_BASE_URLS e OPENAI_API_KEYS accettano elenchi separati da punto e virgola. La prima chiave va con il primo URL.

Due connessioni in un container

-e OPENAI_API_BASE_URLS="https://api.openai.com/v1;http://host.docker.internal:3001/v1" \
-e OPENAI_API_KEYS="<openai-key>;<unified-key>"
Importante: queste variabili vengono salvate nel database di Open WebUI al primo avvio. Dopo, i valori salvati nell'Admin Panel hanno la precedenza sull'ambiente. Se una modifica alle variabili non ha effetto, modifica la connessione nell'Admin Panel. Puoi anche impostare ENABLE_PERSISTENT_CONFIG=False perché prevalga l'ambiente.

Passo 3: tieni breve l'elenco dei modelli

FreeLLMAPI restituisce l'intero catalogo su /v1/models. Il catalogo contiene anche modelli che non puoi ancora usare, perché non hai aggiunto una chiave per essi. Open WebUI mostra ogni modello che la connessione restituisce. Un lungo elenco di modelli che non funzionano non è utile.

Apri di nuovo la connessione e usa il campo Model IDs. Quando aggiungi degli ID, Open WebUI mostra solo questi ID e smette di leggere l'elenco completo. Aggiungi prima le voci del router:

ID del modelloCosa fa il router
autoSegue la catena di fallback attiva dalla dashboard
auto:fastOrdina i modelli abilitati in base alla velocità misurata
auto:smartOrdina i modelli abilitati in base all'intelligenza
auto:reliableOrdina i modelli abilitati in base al tasso di successo recente
auto:<profile>Usa una catena di fallback con nome, per esempio una catena per la visione

Puoi anche aggiungere un ID di modello fisso, per esempio un modello dalla tabella sotto. Un modello fisso dà ogni volta lo stesso stile di risposta. Si ferma anche quando si esaurisce il limite gratuito di quel modello, a meno che lo stesso modello sia gratuito su altri provider.

Per risparmiare quota, imposta come modello di attività una voce veloce. Open WebUI usa il modello di attività per i titoli e le query di ricerca. La variabile è TASK_MODEL_EXTERNAL, per esempio TASK_MODEL_EXTERNAL=auto:fast.

Modelli di chat gratuiti forti con contesto da 128K+
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3APINex, UnoRouter1M5 richieste/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
SìNo
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 altri1M40 richieste/min
40 RPM
SìSì
Gemini 3.8 FlashAPINex, Google AI Studio1M5 richieste/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
SìSì
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceSìNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSìSì
Deepseek V4.1 FlashAPINex1M5 richieste/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NoNo
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSìSì
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìSì
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 richieste/min
50 richieste/giorno
Shared rate limit
SìNo

Mostrati 10 di 184 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.

Se invii immagini in Open WebUI, il router usa solo modelli di visione per quella richiesta. Se nella tua catena non c'è nessun modello di visione, la richiesta restituisce l'errore 422. Questi modelli gratuiti accettano immagini:

Modelli gratuiti con input immagine
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3 FlashUnoRouter1M1 richieste/min
1 req/min per model
SìSì
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSìSì
Gemini Flash (latest alias)Google AI Studio-10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSìSì
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSìSì

Mostrati 6 di 67 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.

Usa embedding gratuiti per i documenti

Open WebUI può creare embedding per i tuoi documenti tramite un'API compatibile con OpenAI. FreeLLMAPI serve /v1/embeddings. Il failover degli embedding non cambia mai il modello, quindi i vettori nel tuo archivio restano compatibili.

Impostazioni degli embedding per Open WebUI

-e RAG_EMBEDDING_ENGINE=openai \
-e RAG_OPENAI_API_BASE_URL=http://host.docker.internal:3001/v1 \
-e RAG_OPENAI_API_KEY=<unified-key> \
-e RAG_EMBEDDING_MODEL=bge-m3

Scegli una famiglia di embedding e mantienila. Se cambi famiglia, crea di nuovo gli embedding di tutti i documenti. I modelli di embedding gratuiti nel catalogo di oggi sono:

ModelloProviderDimensioniInput massimoLimite gratuito
Gemini Embedding
gemini-embedding-001
Google AI Studio30722048100 rpm · 1K req/day
Nemotron Embed VL 1B
nvidia/llama-nemotron-embed-vl-1b-v2
NVIDIA NIM20488192~40 rpm
Nemotron 3 Embed 1B (OR free)
nvidia/nemotron-3-embed-1b:free
OpenRouter20483276820 rpm · shared free daily cap
SEA-LION E5 Embedding 600M
aisingapore/SEA-LION-E5-Embedding-600M
SEA-LION10248192free · 10 rpm
SEA-LION ModernBERT Embedding 300M
aisingapore/SEA-LION-ModernBERT-Embedding-300M
SEA-LION10248192free · 10 rpm
SEA-LION ModernBERT Embedding 600M
aisingapore/SEA-LION-ModernBERT-Embedding-600M
SEA-LION10248192free · 10 rpm
BGE-M3
@cf/baai/bge-m3
Cloudflare Workers AI1024819210K neurons/day (shared)
EmbeddingGemma 300M
@cf/google/embeddinggemma-300m
Cloudflare Workers AI768204810K neurons/day (shared)
Qwen3 Embedding 0.6B
@cf/qwen/qwen3-embedding-0.6b
Cloudflare Workers AI1024819210K neurons/day (shared)
Cohere Embed v4
embed-v4.0
Cohere15361280001K calls/mo (shared w/ chat)
Gemini Embedding 2
gemini-embedding-2
Google AI Studio30728192free-tier rate limited
Nemotron 3 Embed 1B
nvidia/nemotron-3-embed-1b
NVIDIA NIM20484096~40 rpm
PLaMo Embedding 1B (CF)
@cf/pfnet/plamo-embedding-1b
Cloudflare Workers AI2048409610K neurons/day (shared)
BGE Small EN v1.5 (CF)
@cf/baai/bge-small-en-v1.5
Cloudflare Workers AI38451210K neurons/day (shared)
BGE Base EN v1.5 (CF)
@cf/baai/bge-base-en-v1.5
Cloudflare Workers AI76851210K neurons/day (shared)
BGE Large EN v1.5 (CF)
@cf/baai/bge-large-en-v1.5
Cloudflare Workers AI102451210K neurons/day (shared)
Mistral Embed
mistral-embed
Mistral10248192free mode · monthly cap (shared)
Codestral Embed
codestral-embed
Mistral15368192free mode · monthly cap (shared)
Llama Text Embed v2 (Pinecone)
llama-text-embed-v2
Pinecone102420485M tokens/mo per model
Multilingual E5 Large (Pinecone)
multilingual-e5-large
Pinecone10245075M tokens/mo per model
Nemotron 3 Embed 1B (Speka)
nvidia/nemotron-3-embed-1b
Speka20488192$1/month shared across Speka models
OpenAI: Text Embedding 3 Small (ElectronHub)
text-embedding-3-small
ElectronHub15368192$0.25/week shared free credits
OpenAI: Text Embedding 3 Large (ElectronHub)
text-embedding-3-large
ElectronHub30728192$0.25/week shared free credits
Nemotron 3 Embed 8B (Inferbase)
nvidia-nemotron-3-embed-8b
Inferbase409681925,000 requests/month; 100 requests and $0.50 usage/day shared
Qwen 3 Embedding 0.6B (Inferbase)
qwen3-embedding-0-6b
Inferbase102481925,000 requests/month; 100 requests and $0.50 usage/day shared
Qwen 3 Embedding 4B (Inferbase)
qwen3-embedding-4b
Inferbase256081925,000 requests/month; 100 requests and $0.50 usage/day shared
Qwen 3 Embedding 8B (Inferbase)
qwen3-embedding-8b
Inferbase409681925,000 requests/month; 100 requests and $0.50 usage/day shared
LFM2.5 Embedding 350M (LLMTR)
liquid/lfm-2.5-embedding-350m-free
LLMTR1024512Ongoing zero-price route; provider terms apply
BGE-M3 (SEA-LION)
BAAI/bge-m3
SEA-LION10248192free · 10 rpm
Cohere Embed English v3
embed-english-v3.0
Cohere10245121K calls/mo (shared w/ chat)
Qwen3 Embedding 8B (OVH)
Qwen3-Embedding-8B
OVH AI Endpoints409632768free · anonymous 2 req/min per IP
BGE-M3 (OVH)
bge-m3
OVH AI Endpoints10248192free · anonymous 2 req/min per IP
BGE Multilingual Gemma2 (OVH)
bge-multilingual-gemma2
OVH AI Endpoints35848192free · anonymous 2 req/min per IP
Mistral: Codestral Embed (ElectronHub)
codestral-embed
ElectronHub15368192$0.25/week shared free credits
Mistral: Mistral Embed (ElectronHub)
mistral-embed
ElectronHub10248192$0.25/week shared free credits
Google: Gemini Embedding 2 (ElectronHub)
gemini-embedding-2
ElectronHub30728192$0.25/week shared free credits
Google: Gemini Embedding 001 (ElectronHub)
gemini-embedding-001
ElectronHub30722048$0.25/week shared free credits
OpenAI: Text Embedding Ada 002 (ElectronHub)
text-embedding-ada-002
ElectronHub15368192$0.25/week shared free credits
Cohere Embed English Light v3
embed-english-light-v3.0
Cohere3845121K calls/mo (shared w/ chat)
Cohere Embed Multilingual v3
embed-multilingual-v3.0
Cohere10245121K calls/mo (shared w/ chat)
Cohere Embed Multilingual Light v3
embed-multilingual-light-v3.0
Cohere3845121K calls/mo (shared w/ chat)

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.

Risoluzione dei problemi

ProblemaCausaSoluzione
Verify Connection fallisce con un errore di retelocalhost punta al container di Open WebUIUsa host.docker.internal o una rete Docker condivisa, come nel passo 1
Verify Connection fallisce con 401La chiave è errata o contiene spaziCopia di nuovo la chiave unificata dalla pagina Keys
Centinaia di modelli nel selettoreLa connessione legge l'intero catalogoAggiungi auto e gli ID scelti in Model IDs
Un modello fallisce con ogni messaggioNessuna chiave per il provider di quel modelloAggiungi la chiave del provider, oppure seleziona auto
Errore 429 dopo molte chatTutte le chiavi dei provider nella catena hanno raggiunto il limiteAggiungi chiavi di altri provider, oppure attendi l'orario di reset indicato nell'intestazione Retry-After
Le variabili d'ambiente non hanno effettoHanno la precedenza i valori salvati nel databaseModifica la connessione nell'Admin Panel

Per vedere quale provider ha risposto a una chat, leggi l'intestazione X-Routed-Via della risposta. Il visualizzatore dei Server Logs nel menu Analytics della dashboard mostra anche le decisioni di routing e i cooldown delle chiavi.

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

Esiste un'API gratuita per Open WebUI?

Sì. Open WebUI funziona con qualsiasi API compatibile con OpenAI. FreeLLMAPI riunisce i piani gratuiti dei provider dietro un unico URL e una sola chiave. Ogni piano gratuito ha i suoi limiti.

Quale URL uso per una connessione compatibile con OpenAI in Open WebUI?

Usa l'URL base con /v1 alla fine, per esempio http://host.docker.internal:3001/v1. Non aggiungere /chat/completions. Se Open WebUI gira in Docker, non usare localhost.

Perché Open WebUI ignora la modifica di OPENAI_API_BASE_URL?

Open WebUI salva le impostazioni della connessione nel suo database dopo il primo avvio. I valori nel database hanno la precedenza. Modifica la connessione nell'Admin Panel, oppure imposta ENABLE_PERSISTENT_CONFIG=False.

Open WebUI può usare più provider gratuiti insieme?

Sì. Puoi aggiungere una connessione per ogni provider. Con FreeLLMAPI basta una connessione, perché il router sceglie il provider e passa al successivo quando un limite blocca una richiesta.

Qual è il modello gratuito migliore in Open WebUI?

Inizia con auto. Segue la tua catena di fallback. Per un modello fisso, scegline uno con una finestra di contesto ampia dalla tabella di questa pagina.

Guide correlate

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti