Início / Guias / API LLM gratuita para Open WebUI

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 | bash

Etapa 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 rodaO FreeLLMAPI rodaURL 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 hosthttp://host.docker.internal:3001/v1
No Docker no LinuxNo Docker (script de instalação)http://freellmapi:3001/v1 em uma rede Docker compartilhada
Em outro computadorEm um servidor na sua rede localhttp://<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 300

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

  1. Abra o Admin Panel e vá em Settings > Connections.
  2. Encontre a lista Manage OpenAI API Connections. Clique em Add Connection.
  3. Em URL, digite a URL da Etapa 1, por exemplo http://host.docker.internal:3001/v1.
  4. Em API Key, cole a sua chave unificada do FreeLLMAPI.
  5. 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:main

Para 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>"
Importante: estas variáveis são salvas no banco de dados do Open WebUI na primeira inicialização. Depois disso, os valores salvos no Admin Panel têm prioridade sobre o ambiente. Se uma mudança nas variáveis não tiver efeito, edite a conexão no Admin Panel. Você também pode definir 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 modeloO que o roteador faz
autoSegue a sua cadeia de fallback ativa no painel
auto:fastOrdena os modelos habilitados pela velocidade medida
auto:smartOrdena os modelos habilitados pela inteligência
auto:reliableOrdena 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.

Modelos gratuitos de chat fortes, com contexto de 128K ou mais
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3APINex, UnoRouter1M5 req/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
SimNão
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 a mais1M40 req/min
40 RPM
SimSim
Gemini 3.8 FlashAPINex, Google AI Studio1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
SimSim
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceSimNão
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSimSim
Deepseek V4.1 FlashAPINex1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NãoNão
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSimSim
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/dia
50 req/day account-wide (1,000 after a $10 purchase)
SimSim
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/dia
Shared rate limit
SimNã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:

Modelos gratuitos com entrada de imagem
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3 FlashUnoRouter1M1 req/min
1 req/min per model
SimSim
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSimSim
Gemini Flash (latest alias)Google AI Studio-10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSimSim
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSimSim

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-m3

Escolha 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:

ModeloProvedorDimensõesEntrada máx.Limite 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)

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

ProblemaCausaSolução
Verify Connection falha com erro de redelocalhost aponta para o contêiner do Open WebUIUse host.docker.internal ou uma rede Docker compartilhada, como na Etapa 1
Verify Connection falha com 401A chave está errada ou tem espaçosCopie a chave unificada de novo na página Keys
Centenas de modelos no seletorA conexão lê o catálogo completoAdicione auto e os IDs escolhidos em Model IDs
Um modelo falha em todas as mensagensNão há chave para o provedor desse modeloAdicione a chave do provedor ou selecione auto
Erro 429 depois de muitos chatsTodas as chaves de provedores da cadeia estão no limiteAdicione 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 efeitoOs valores salvos no banco de dados têm prioridadeEdite 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.

Use todos estes modelos com uma única chave. FreeLLMAPI é um roteador de código aberto e de hospedagem própria. Ele coloca todas estas camadas gratuitas atrás de um único endpoint compatível com OpenAI e passa para o próximo provedor quando um deles está com limite de requisições. Ver o catálogo ou colocar em produção.

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

Fontes

Todos os guias · Ver todos os modelos gratuitos