API LLM gratuita para n8n
n8n é uma ferramenta de automação de fluxos de trabalho com nós de IA. Sua credencial OpenAI tem um campo Base URL, então você pode enviar as requisições para qualquer API compatível com OpenAI. Este guia aponta esse campo para o FreeLLMAPI. O FreeLLMAPI reúne 45 planos gratuitos de provedores atrás de uma única chave 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.
O que você precisa
- n8n, self-hosted ou no n8n Cloud. Uma instância na nuvem não consegue acessar
localhostno seu computador. No n8n Cloud, o FreeLLMAPI precisa ter um endereço HTTPS público. - FreeLLMAPI, instalado com Docker ou com o aplicativo de desktop. Adicione pelo menos duas chaves de provedores gratuitos na página Keys.
- A chave unificada da página Keys do FreeLLMAPI. O n8n usa somente esta chave.
Instale o FreeLLMAPI (macOS ou Linux)
curl -fsSL https://freellmapi.co/install.sh | bashA Base URL depende de onde o n8n é executado. Dentro de um contêiner Docker, localhost é o próprio contêiner, não o seu computador.
| O n8n é executado | Base URL |
|---|---|
| No host (npm ou npx) | http://localhost:3001/v1 |
| No Docker Desktop (macOS, Windows) | http://host.docker.internal:3001/v1 |
| No Docker em Linux, mesmo host do FreeLLMAPI | http://freellmapi:3001/v1, depois de conectar o contêiner do n8n à rede Docker do FreeLLMAPI |
| n8n Cloud | O endereço HTTPS público do seu servidor FreeLLMAPI, com /v1 no final |
Etapa 1: crie a credencial OpenAI
- No n8n, abra Credentials e crie uma nova credencial do tipo OpenAI.
- Em API Key, cole a sua chave unificada do FreeLLMAPI.
- Deixe Organization ID (optional) vazio.
- Em Base URL, substitua
https://api.openai.com/v1pela URL do seu FreeLLMAPI, por exemplohttp://host.docker.internal:3001/v1. - Salve a credencial.
Todos os nós OpenAI que usam esta credencial agora enviam as requisições para o FreeLLMAPI. Suas chaves reais de provedores ficam no FreeLLMAPI. Elas não vão para o n8n.
Teste a URL a partir do contêiner do n8n
docker exec n8n wget -qO- \
--header="Authorization: Bearer <unified-key>" \
http://host.docker.internal:3001/v1/models | head -c 300Etapa 2: crie um fluxo com AI Agent
O nó AI Agent precisa de um sub-nó de modelo de chat e de pelo menos um sub-nó de ferramenta. Desde o n8n 1.82.0, todo nó AI Agent funciona como um Tools Agent. O agente envia as definições de ferramentas ao modelo, então o modelo precisa oferecer suporte à chamada de ferramentas.
- Adicione um nó Chat Trigger. Ele oferece uma janela de chat para testar o fluxo.
- Adicione um nó AI Agent depois do gatilho.
- Conecte um sub-nó OpenAI Chat Model à entrada Chat Model do agente. Selecione a sua credencial do FreeLLMAPI.
- Em Model, mude o modo de From List para ID. Digite
auto. - Conecte um sub-nó de ferramenta, por exemplo a ferramenta Calculator ou uma ferramenta HTTP Request.
- Abra o chat e envie uma mensagem de teste.
Use o modo ID para o modelo. O modo de lista mostra o catálogo completo do FreeLLMAPI, que também contém modelos que você ainda não pode chamar. Estes IDs são úteis no n8n:
| ID do modelo | Use para |
|---|---|
auto | Fluxos gerais. O roteador segue a sua cadeia de fallback. |
auto:fast | Classificação, resumos curtos e outras etapas de alto volume |
auto:smart | Etapas de agente que precisam planejar ou selecionar ferramentas |
auto:reliable | Fluxos agendados que não podem falhar |
auto:<profile> | Uma cadeia de fallback nomeada, por exemplo uma que tenha só modelos com chamada de ferramentas |
Para etapas de agente, mantenha na cadeia somente modelos com chamada de ferramentas. Estes modelos gratuitos oferecem suporte à chamada de ferramentas hoje:
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Sim | Não |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Sim | Sim |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sim | Sim |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sim | Não |
| 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 |
| 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 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/dia 70,000 tokens/min ~6M | Sim | Sim |
Mostrando 10 de 109 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.
Etapa 3: trate os limites dos planos gratuitos
Um fluxo que percorre 500 itens envia 500 requisições. Os planos gratuitos limitam as requisições por minuto e por dia. O FreeLLMAPI conta a cota de cada chave e passa para o próximo provedor quando recebe um erro 429. Quando todas as chaves da cadeia atingem o limite, o gateway retorna 429 com um cabeçalho Retry-After.
Defina estas opções para que um limite curto não pare o fluxo:
| Onde | Configuração | Valor |
|---|---|---|
| OpenAI Chat Model, Options | Max Retries | 3 a 5 |
| OpenAI Chat Model, Options | Timeout | 60000 ms ou mais para prompts longos |
| Configurações do nó (ícone de engrenagem) | Retry On Fail | Ativado |
| Configurações do nó | Max. Tries | 3 |
| Configurações do nó | Wait Between Tries (ms) | 5000 ou mais |
| Nó Loop Over Items | Batch Size | Lotes pequenos, com um nó Wait entre eles |
Adicione chaves de mais provedores para aumentar o total de requisições por dia. A tabela mostra os limites gratuitos de cada provedor no catálogo de hoje.
| Provedor | Modelos gratuitos | Máx. req/min | Máx. req/dia | Máx. tokens/min | Tokens/mês (um modelo) | Modelo gratuito mais forte |
|---|---|---|---|---|---|---|
| ElectronHub | 84 | - | - | - | $0.25/week shared recurring credit | Qwen3.8 Flash (ElectronHub)qwen3.8-flash |
| Cloudflare Workers AI | 39 | - | - | - | ~5-10M | Qwen 3.8 27B (Cloudflare Workers AI)@cf/qwen/qwen3.8-27b |
| Inferbase | 38 | - | - | - | 5,000 requests/month; 100 requests and $0.50 usage/day shared | DeepSeek V4 Flash (fp8) (Inferbase)deepseek-v4-flash:fp8 |
| AI Horde | 31 | - | - | - | Ongoing volunteer queue; availability varies | Gemma 4 31B Heretic (AI Horde)koboldcpp/gemma-4-31B-it-heretic |
| ACLIDE | 29 | - | - | - | €20/month shared internal usage credits · no card | Qwen3.8 Max (ACLIDE)qwen/qwen3.8-max:free |
| Google AI Studio | 21 | 15 | 1,000 | 250,000 | ~3M | Gemini 3.8 Flashgemini-3.8-flash |
| Api.Airforce | 20 | 1 | 1,000 | - | free · 1,000 req/day · 1 req/min | gpt-oss-20b (Api.Airforce)gpt-oss-20b |
| NVIDIA NIM | 19 | 40 | - | - | free · 40 RPM | GLM 5.3 Flash (NV)z-ai/glm-5.3-flash |
| Cohere | 17 | 20 | 33 | - | ~1-2M | Command A+ (05-2026)command-a-plus-05-2026 |
| DreamPrompting | 14 | 100 | 5,000 | - | free · 500K tokens/day · 5,000 req/day | Gemini 3.1 Flash-Litegoogle/gemini-3.1-flash-lite |
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 o nó HTTP Request
Você também pode chamar o FreeLLMAPI com o nó genérico HTTP Request. Use este método quando precisar de um parâmetro que o nó OpenAI não mostra ou quando quiser ver os cabeçalhos da resposta.
- Método:
POST - URL:
http://host.docker.internal:3001/v1/chat/completions - Cabeçalho:
Authorizationcom o valorBearer <unified-key> - Body content type: JSON
Corpo JSON
{
"model": "auto:fast",
"messages": [
{"role": "system", "content": "Classify the ticket as billing, bug or other. Reply with one word."},
{"role": "user", "content": "{{ $json.ticket_text }}"}
],
"temperature": 0
}A resposta está em choices[0].message.content. O cabeçalho de resposta X-Routed-Via mostra o provedor e o modelo que responderam. Se o roteador trocou de provedor, X-Fallback-Attempts mostra o número de tentativas que falharam.
Solução de problemas
| Problema | Causa | Solução |
|---|---|---|
| O teste da credencial falha com erro de conexão | localhost aponta para o contêiner do n8n | Use host.docker.internal ou uma rede Docker compartilhada |
| Erro 401 | Chave errada | Cole a chave unificada novamente |
| A lista de modelos tem centenas de entradas | O modo de lista lê o catálogo completo | Use o modo ID e digite auto |
| O agente responde, mas nunca usa uma ferramenta | O modelo selecionado não oferece suporte à chamada de ferramentas | Use um modelo da tabela acima ou um perfil com modelos que suportam chamada de ferramentas |
| Erro 429 em um loop longo | Todas as chaves atingiram o limite | Adicione provedores, use lotes menores e ative Retry On Fail |
| O nó excede o tempo limite | Um modelo gratuito lento com um prompt longo | Aumente o Timeout ou use auto:fast |
Perguntas frequentes
Posso usar uma URL base própria com o nó OpenAI do n8n?
Sim. A credencial OpenAI no n8n tem um campo Base URL. Defina-o como uma URL compatível com OpenAI que termine em /v1, por exemplo http://localhost:3001/v1 para o FreeLLMAPI.
Existe uma API LLM gratuita para n8n?
Sim. Os planos gratuitos de provedores funcionam no n8n pela credencial OpenAI. O FreeLLMAPI combina muitos planos gratuitos atrás de uma única chave. Cada plano tem seus próprios limites de requisições.
Qual modelo gratuito funciona com o nó AI Agent do n8n?
Use um modelo que ofereça suporte à chamada de ferramentas, porque o nó AI Agent funciona como um Tools Agent. A tabela desta página lista modelos gratuitos com chamada de ferramentas.
Como evitar que os fluxos do n8n falhem por causa de limites de requisições?
Defina Max Retries no nó do modelo de chat, ative Retry On Fail nas configurações do nó e processe os itens em lotes pequenos. Adicione chaves de mais provedores para aumentar o total diário.
O n8n Cloud funciona com um gateway LLM self-hosted?
Somente se o gateway tiver um endereço HTTPS público. O n8n Cloud não consegue acessar localhost no seu computador.
Guias relacionados
- API LLM gratuita para agentes de IA
- API LLM gratuita com function calling
- URLs base de APIs gratuitas compatíveis com OpenAI
- Limites de taxa da API LLM gratuita
- API LLM gratuita para LangChain
Fontes
- n8n source: OpenAI credential fields (API Key, Organization ID, Base URL) (verificado em 20 November 2026)
- n8n docs: OpenAI Chat Model node (verificado em 20 November 2026)
- n8n docs: AI Agent node (verificado em 20 November 2026)
- n8n docs: node settings (Retry On Fail) (verificado em 20 November 2026)
- FreeLLMAPI docs: REST API (routing strategies, response headers) (verificado em 20 November 2026)