API LLM gratuita para Open WebUI
Open WebUI é uma interface de chat de hospedagem própria. Ela se conecta a qualquer servidor que use a API Chat Completions da OpenAI. Este guia conecta o Open WebUI ao FreeLLMAPI, que reúne camadas gratuitas de 45 provedores atrás de uma única chave. Você adiciona uma conexão. O roteador envia cada chat para um modelo gratuito e passa para o próximo provedor quando um limite bloqueia uma requisição.
O código, os nomes dos modelos e os rótulos do catálogo ao vivo são exibidos em inglês.
Como a conexão funciona
O Open WebUI envia as requisições de chat para a URL de cada conexão OpenAI. O FreeLLMAPI escuta em http://localhost:3001/v1 e aceita as mesmas requisições. Ele escolhe um modelo gratuito, envia a requisição e devolve a resposta no formato OpenAI.
- Uma conexão, muitos provedores: você adiciona uma URL e uma chave unificada. As chaves dos provedores ficam no FreeLLMAPI, no seu computador.
- Fallback: quando um provedor devolve o erro 429, o roteador tenta o próximo modelo da sua cadeia de fallback.
- Limites: as camadas gratuitas têm limites de requisições e de tokens. Mais chaves de provedores permitem mais requisições por dia. O fallback distribui a carga, mas não remove os limites.
Instale o FreeLLMAPI primeiro. Ele roda no Docker. Abra o painel em http://localhost:3001, adicione pelo menos duas chaves gratuitas de provedores na página Keys e copie a sua chave unificada.
Instalar o FreeLLMAPI (macOS ou Linux)
curl -fsSL https://freellmapi.co/install.sh | bashEtapa 1: encontre a URL correta
A URL que o Open WebUI deve usar depende de onde cada programa roda. O Open WebUI geralmente roda no Docker. Dentro de um contêiner, localhost é o próprio contêiner, e não o seu computador.
| O Open WebUI roda | O FreeLLMAPI roda | URL a usar |
|---|---|---|
| Direto no host (pip ou uv) | No host (Docker ou aplicativo de desktop) | http://localhost:3001/v1 |
| No Docker Desktop (macOS, Windows) | No host | http://host.docker.internal:3001/v1 |
| No Docker no Linux | No Docker (script de instalação) | http://freellmapi:3001/v1 em uma rede Docker compartilhada |
| Em outro computador | Em um servidor na sua rede local | http://<server-ip>:3001/v1, com HOST_BIND=0.0.0.0 somente em uma rede confiável |
Por padrão, o contêiner do FreeLLMAPI publica a sua porta somente em 127.0.0.1. No Linux, um segundo contêiner nem sempre consegue acessar essa porta pelo host. Conecte os dois contêineres a uma mesma rede Docker. Depois, use o nome de serviço freellmapi como nome de host.
Conectar o Open WebUI à rede do 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 300Etapa 2: adicione a conexão
Você pode adicionar a conexão na interface ou com variáveis de ambiente. A interface é o método mais simples.
- Abra o Admin Panel e vá em Settings > Connections.
- Encontre a lista Manage OpenAI API Connections. Clique em Add Connection.
- Em URL, digite a URL da Etapa 1, por exemplo
http://host.docker.internal:3001/v1. - Em API Key, cole a sua chave unificada do FreeLLMAPI.
- Clique em Verify Connection. Depois, clique em Save.
Para definir a conexão quando o contêiner iniciar, use OPENAI_API_BASE_URL e OPENAI_API_KEY. O comando abaixo é o comando padrão docker run do Open WebUI, com essas duas variáveis adicionadas.
docker run com a conexão do 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:mainPara manter uma conexão OpenAI existente, use as variáveis no plural. OPENAI_API_BASE_URLS e OPENAI_API_KEYS recebem listas separadas por ponto e vírgula. A primeira chave vai com a primeira URL.
Duas conexões em um contêiner
-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 para que o ambiente prevaleça.Etapa 3: mantenha a lista de modelos curta
O FreeLLMAPI devolve o catálogo completo em /v1/models. O catálogo também inclui modelos que você ainda não pode usar, porque não adicionou uma chave para eles. O Open WebUI mostra todos os modelos que a conexão devolve. Uma lista longa de modelos que falham não é útil.
Abra a conexão de novo e use o campo Model IDs. Quando você adiciona IDs, o Open WebUI mostra somente esses IDs e deixa de ler a lista completa. Adicione primeiro as entradas do roteador:
| ID do modelo | O que o roteador faz |
|---|---|
auto | Segue a sua cadeia de fallback ativa no painel |
auto:fast | Ordena os modelos habilitados pela velocidade medida |
auto:smart | Ordena os modelos habilitados pela inteligência |
auto:reliable | Ordena os modelos habilitados pela taxa de sucesso recente |
auto:<profile> | Usa uma cadeia de fallback nomeada, por exemplo uma cadeia de visão |
Você também pode adicionar um ID de modelo fixo, por exemplo um modelo da tabela abaixo. Um modelo fixo dá sempre o mesmo estilo de resposta. Ele também para quando o limite gratuito desse modelo se esgota, a menos que o mesmo modelo seja gratuito em outros provedores.
Para economizar cota, defina o modelo de tarefas como uma entrada rápida. O Open WebUI usa o modelo de tarefas para títulos e consultas de busca. A variável é TASK_MODEL_EXTERNAL, por exemplo TASK_MODEL_EXTERNAL=auto:fast.
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Sim | Não |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 a mais | 1M | 40 req/min 40 RPM | Sim | Sim |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Sim | Sim |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Sim | Não |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Deepseek V4.1 Flash | APINex | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Não | Não |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/dia 50 req/day account-wide (1,000 after a $10 purchase) | Sim | Sim |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/dia Shared rate limit | Sim | Não |
Mostrando 10 de 184 modelos gratuitos correspondentes. Ver todos os modelos.
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
Se você envia imagens no Open WebUI, o roteador usa somente modelos de visão nessa requisição. Se nenhum modelo de visão estiver na sua cadeia, a requisição devolve o erro 422. Estes modelos gratuitos aceitam imagens:
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| GLM 5.3 Flash | UnoRouter | 1M | 1 req/min 1 req/min per model | Sim | Sim |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sim | Sim |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
Mostrando 6 de 67 modelos gratuitos correspondentes. Ver todos os modelos.
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
Use embeddings gratuitos para documentos
O Open WebUI pode criar embeddings para os seus documentos por meio de uma API compatível com OpenAI. O FreeLLMAPI atende /v1/embeddings. O fallback de embeddings nunca troca o modelo, então os vetores no seu armazenamento continuam compatíveis.
Configurações de embedding para o 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-m3Escolha uma família de embeddings e mantenha-a. Se você trocar a família, gere os embeddings de todos os documentos novamente. Os modelos de embedding gratuitos no catálogo de hoje são:
| Modelo | Provedor | Dimensões | Entrada máx. | 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) |
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
Solução de problemas
| Problema | Causa | Solução |
|---|---|---|
| Verify Connection falha com erro de rede | localhost aponta para o contêiner do Open WebUI | Use host.docker.internal ou uma rede Docker compartilhada, como na Etapa 1 |
| Verify Connection falha com 401 | A chave está errada ou tem espaços | Copie a chave unificada de novo na página Keys |
| Centenas de modelos no seletor | A conexão lê o catálogo completo | Adicione auto e os IDs escolhidos em Model IDs |
| Um modelo falha em todas as mensagens | Não há chave para o provedor desse modelo | Adicione a chave do provedor ou selecione auto |
| Erro 429 depois de muitos chats | Todas as chaves de provedores da cadeia estão no limite | Adicione chaves de mais provedores ou espere o horário de reinício no cabeçalho Retry-After |
| Variáveis de ambiente não têm efeito | Os valores salvos no banco de dados têm prioridade | Edite a conexão no Admin Panel |
Para ver qual provedor respondeu a um chat, leia o cabeçalho X-Routed-Via da resposta. O visualizador Server Logs, no menu Analytics do painel, também mostra as decisões de roteamento e os períodos de espera das chaves.
Perguntas frequentes
Existe uma API gratuita para o Open WebUI?
Sim. O Open WebUI funciona com qualquer API compatível com OpenAI. O FreeLLMAPI combina camadas gratuitas de provedores atrás de uma URL e uma chave. Cada camada gratuita tem os seus próprios limites.
Qual URL devo usar em uma conexão compatível com OpenAI no Open WebUI?
Use a URL base com /v1 no final, por exemplo http://host.docker.internal:3001/v1. Não adicione /chat/completions. Se o Open WebUI roda no Docker, não use localhost.
Por que o Open WebUI ignora a mudança em OPENAI_API_BASE_URL?
O Open WebUI salva as configurações da conexão no banco de dados depois da primeira inicialização. Os valores do banco têm prioridade. Edite a conexão no Admin Panel ou defina ENABLE_PERSISTENT_CONFIG=False.
O Open WebUI pode usar vários provedores gratuitos ao mesmo tempo?
Sim. Você pode adicionar uma conexão por provedor. Com o FreeLLMAPI, uma conexão basta, porque o roteador escolhe o provedor e passa para o próximo quando um limite bloqueia uma requisição.
Qual é o melhor modelo gratuito no Open WebUI?
Comece com auto. Ele segue a sua cadeia de fallback. Para um modelo fixo, escolha um com janela de contexto grande na tabela desta página.
Guias relacionados
- API gratuita para SillyTavern
- URLs base de APIs gratuitas compatíveis com OpenAI
- API gratuita de embeddings
- API LLM gratuita para RAG
- Limites de taxa da API LLM gratuita
Fontes
- Open WebUI docs: environment variable configuration (verificado em 20 November 2026)
- Open WebUI docs: connect an OpenAI-compatible provider (verificado em 20 November 2026)
- Open WebUI README: Docker installation (verificado em 20 November 2026)
- FreeLLMAPI docs: REST API (routing strategies, model listing, embeddings) (verificado em 20 November 2026)
- FreeLLMAPI docs: Docker deployment (verificado em 20 November 2026)