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 | bashPasso 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 gira | FreeLLMAPI gira | URL da usare |
|---|---|---|
| Sull'host (pip o uv) | Sull'host (Docker o app desktop) | http://localhost:3001/v1 |
| In Docker Desktop (macOS, Windows) | Sull'host | http://host.docker.internal:3001/v1 |
| In Docker su Linux | In Docker (script di installazione) | http://freellmapi:3001/v1 su una rete Docker condivisa |
| Su un altro computer | Su un server nella tua LAN | http://<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 300Passo 2: aggiungi la connessione
Puoi aggiungere la connessione nell'interfaccia o con le variabili d'ambiente. L'interfaccia è il metodo più semplice.
- Apri l'Admin Panel e vai su Settings > Connections.
- Trova l'elenco Manage OpenAI API Connections. Clicca su Add Connection.
- In URL, scrivi l'URL del passo 1, per esempio
http://host.docker.internal:3001/v1. - In API Key, incolla la tua chiave unificata di FreeLLMAPI.
- 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:mainPer 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>"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 modello | Cosa fa il router |
|---|---|
auto | Segue la catena di fallback attiva dalla dashboard |
auto:fast | Ordina i modelli abilitati in base alla velocità misurata |
auto:smart | Ordina i modelli abilitati in base all'intelligenza |
auto:reliable | Ordina 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.
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 richieste/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Sì | No |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 altri | 1M | 40 richieste/min 40 RPM | Sì | Sì |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 richieste/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Sì | Sì |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Sì | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Deepseek V4.1 Flash | APINex | 1M | 5 richieste/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | No | No |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 richieste/min 50 richieste/giorno 50 req/day account-wide (1,000 after a $10 purchase) | Sì | Sì |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 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:
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| GLM 5.3 Flash | UnoRouter | 1M | 1 richieste/min 1 req/min per model | Sì | Sì |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sì | Sì |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | Sì |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 richieste/min 20 richieste/giorno 250,000 token/min ~3M | Sì | Sì |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sì | 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-m3Scegli 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:
| Modello | Provider | Dimensioni | Input massimo | Limite gratuito |
|---|---|---|---|---|
Gemini Embeddinggemini-embedding-001 | Google AI Studio | 3072 | 2048 | 100 rpm · 1K req/day |
Nemotron Embed VL 1Bnvidia/llama-nemotron-embed-vl-1b-v2 | NVIDIA NIM | 2048 | 8192 | ~40 rpm |
Nemotron 3 Embed 1B (OR free)nvidia/nemotron-3-embed-1b:free | OpenRouter | 2048 | 32768 | 20 rpm · shared free daily cap |
SEA-LION E5 Embedding 600Maisingapore/SEA-LION-E5-Embedding-600M | SEA-LION | 1024 | 8192 | free · 10 rpm |
SEA-LION ModernBERT Embedding 300Maisingapore/SEA-LION-ModernBERT-Embedding-300M | SEA-LION | 1024 | 8192 | free · 10 rpm |
SEA-LION ModernBERT Embedding 600Maisingapore/SEA-LION-ModernBERT-Embedding-600M | SEA-LION | 1024 | 8192 | free · 10 rpm |
BGE-M3@cf/baai/bge-m3 | Cloudflare Workers AI | 1024 | 8192 | 10K neurons/day (shared) |
EmbeddingGemma 300M@cf/google/embeddinggemma-300m | Cloudflare Workers AI | 768 | 2048 | 10K neurons/day (shared) |
Qwen3 Embedding 0.6B@cf/qwen/qwen3-embedding-0.6b | Cloudflare Workers AI | 1024 | 8192 | 10K neurons/day (shared) |
Cohere Embed v4embed-v4.0 | Cohere | 1536 | 128000 | 1K calls/mo (shared w/ chat) |
Gemini Embedding 2gemini-embedding-2 | Google AI Studio | 3072 | 8192 | free-tier rate limited |
Nemotron 3 Embed 1Bnvidia/nemotron-3-embed-1b | NVIDIA NIM | 2048 | 4096 | ~40 rpm |
PLaMo Embedding 1B (CF)@cf/pfnet/plamo-embedding-1b | Cloudflare Workers AI | 2048 | 4096 | 10K neurons/day (shared) |
BGE Small EN v1.5 (CF)@cf/baai/bge-small-en-v1.5 | Cloudflare Workers AI | 384 | 512 | 10K neurons/day (shared) |
BGE Base EN v1.5 (CF)@cf/baai/bge-base-en-v1.5 | Cloudflare Workers AI | 768 | 512 | 10K neurons/day (shared) |
BGE Large EN v1.5 (CF)@cf/baai/bge-large-en-v1.5 | Cloudflare Workers AI | 1024 | 512 | 10K neurons/day (shared) |
Mistral Embedmistral-embed | Mistral | 1024 | 8192 | free mode · monthly cap (shared) |
Codestral Embedcodestral-embed | Mistral | 1536 | 8192 | free mode · monthly cap (shared) |
Llama Text Embed v2 (Pinecone)llama-text-embed-v2 | Pinecone | 1024 | 2048 | 5M tokens/mo per model |
Multilingual E5 Large (Pinecone)multilingual-e5-large | Pinecone | 1024 | 507 | 5M tokens/mo per model |
Nemotron 3 Embed 1B (Speka)nvidia/nemotron-3-embed-1b | Speka | 2048 | 8192 | $1/month shared across Speka models |
OpenAI: Text Embedding 3 Small (ElectronHub)text-embedding-3-small | ElectronHub | 1536 | 8192 | $0.25/week shared free credits |
OpenAI: Text Embedding 3 Large (ElectronHub)text-embedding-3-large | ElectronHub | 3072 | 8192 | $0.25/week shared free credits |
Nemotron 3 Embed 8B (Inferbase)nvidia-nemotron-3-embed-8b | Inferbase | 4096 | 8192 | 5,000 requests/month; 100 requests and $0.50 usage/day shared |
Qwen 3 Embedding 0.6B (Inferbase)qwen3-embedding-0-6b | Inferbase | 1024 | 8192 | 5,000 requests/month; 100 requests and $0.50 usage/day shared |
Qwen 3 Embedding 4B (Inferbase)qwen3-embedding-4b | Inferbase | 2560 | 8192 | 5,000 requests/month; 100 requests and $0.50 usage/day shared |
Qwen 3 Embedding 8B (Inferbase)qwen3-embedding-8b | Inferbase | 4096 | 8192 | 5,000 requests/month; 100 requests and $0.50 usage/day shared |
LFM2.5 Embedding 350M (LLMTR)liquid/lfm-2.5-embedding-350m-free | LLMTR | 1024 | 512 | Ongoing zero-price route; provider terms apply |
BGE-M3 (SEA-LION)BAAI/bge-m3 | SEA-LION | 1024 | 8192 | free · 10 rpm |
Cohere Embed English v3embed-english-v3.0 | Cohere | 1024 | 512 | 1K calls/mo (shared w/ chat) |
Qwen3 Embedding 8B (OVH)Qwen3-Embedding-8B | OVH AI Endpoints | 4096 | 32768 | free · anonymous 2 req/min per IP |
BGE-M3 (OVH)bge-m3 | OVH AI Endpoints | 1024 | 8192 | free · anonymous 2 req/min per IP |
BGE Multilingual Gemma2 (OVH)bge-multilingual-gemma2 | OVH AI Endpoints | 3584 | 8192 | free · anonymous 2 req/min per IP |
Mistral: Codestral Embed (ElectronHub)codestral-embed | ElectronHub | 1536 | 8192 | $0.25/week shared free credits |
Mistral: Mistral Embed (ElectronHub)mistral-embed | ElectronHub | 1024 | 8192 | $0.25/week shared free credits |
Google: Gemini Embedding 2 (ElectronHub)gemini-embedding-2 | ElectronHub | 3072 | 8192 | $0.25/week shared free credits |
Google: Gemini Embedding 001 (ElectronHub)gemini-embedding-001 | ElectronHub | 3072 | 2048 | $0.25/week shared free credits |
OpenAI: Text Embedding Ada 002 (ElectronHub)text-embedding-ada-002 | ElectronHub | 1536 | 8192 | $0.25/week shared free credits |
Cohere Embed English Light v3embed-english-light-v3.0 | Cohere | 384 | 512 | 1K calls/mo (shared w/ chat) |
Cohere Embed Multilingual v3embed-multilingual-v3.0 | Cohere | 1024 | 512 | 1K calls/mo (shared w/ chat) |
Cohere Embed Multilingual Light v3embed-multilingual-light-v3.0 | Cohere | 384 | 512 | 1K 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
| Problema | Causa | Soluzione |
|---|---|---|
| Verify Connection fallisce con un errore di rete | localhost punta al container di Open WebUI | Usa host.docker.internal o una rete Docker condivisa, come nel passo 1 |
| Verify Connection fallisce con 401 | La chiave è errata o contiene spazi | Copia di nuovo la chiave unificata dalla pagina Keys |
| Centinaia di modelli nel selettore | La connessione legge l'intero catalogo | Aggiungi auto e gli ID scelti in Model IDs |
| Un modello fallisce con ogni messaggio | Nessuna chiave per il provider di quel modello | Aggiungi la chiave del provider, oppure seleziona auto |
| Errore 429 dopo molte chat | Tutte le chiavi dei provider nella catena hanno raggiunto il limite | Aggiungi chiavi di altri provider, oppure attendi l'orario di reset indicato nell'intestazione Retry-After |
| Le variabili d'ambiente non hanno effetto | Hanno la precedenza i valori salvati nel database | Modifica 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.
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
- API gratuita per SillyTavern
- Base URL di API gratuite compatibili con OpenAI
- API gratuita per embedding
- API LLM gratuita per RAG
- Rate limit delle Free LLM API
Fonti
- Open WebUI docs: environment variable configuration (verificato il 20 November 2026)
- Open WebUI docs: connect an OpenAI-compatible provider (verificato il 20 November 2026)
- Open WebUI README: Docker installation (verificato il 20 November 2026)
- FreeLLMAPI docs: REST API (routing strategies, model listing, embeddings) (verificato il 20 November 2026)
- FreeLLMAPI docs: Docker deployment (verificato il 20 November 2026)