Início / Guias / API LLM gratuita para n8n

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

A 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 é executadoBase 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 FreeLLMAPIhttp://freellmapi:3001/v1, depois de conectar o contêiner do n8n à rede Docker do FreeLLMAPI
n8n CloudO endereço HTTPS público do seu servidor FreeLLMAPI, com /v1 no final

Etapa 1: crie a credencial OpenAI

  1. No n8n, abra Credentials e crie uma nova credencial do tipo OpenAI.
  2. Em API Key, cole a sua chave unificada do FreeLLMAPI.
  3. Deixe Organization ID (optional) vazio.
  4. Em Base URL, substitua https://api.openai.com/v1 pela URL do seu FreeLLMAPI, por exemplo http://host.docker.internal:3001/v1.
  5. 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 300

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

  1. Adicione um nó Chat Trigger. Ele oferece uma janela de chat para testar o fluxo.
  2. Adicione um nó AI Agent depois do gatilho.
  3. Conecte um sub-nó OpenAI Chat Model à entrada Chat Model do agente. Selecione a sua credencial do FreeLLMAPI.
  4. Em Model, mude o modo de From List para ID. Digite auto.
  5. Conecte um sub-nó de ferramenta, por exemplo a ferramenta Calculator ou uma ferramenta HTTP Request.
  6. 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 modeloUse para
autoFluxos gerais. O roteador segue a sua cadeia de fallback.
auto:fastClassificação, resumos curtos e outras etapas de alto volume
auto:smartEtapas de agente que precisam planejar ou selecionar ferramentas
auto:reliableFluxos 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:

Modelos gratuitos com chamada de ferramentas e contexto de 128K ou mais
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
SimNão
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
SimSim
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSimSim
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSimNão
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
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
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/dia
70,000 tokens/min
~6M
SimSim

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.

Use Responses API: deixe esta opção desativada no nó OpenAI Chat Model. As ferramentas integradas por trás dela (Web Search, File Search, Code Interpreter) são serviços da OpenAI. A documentação do FreeLLMAPI não descreve suporte a elas. Use sub-nós de ferramenta do n8n para essas tarefas.

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:

OndeConfiguraçãoValor
OpenAI Chat Model, OptionsMax Retries3 a 5
OpenAI Chat Model, OptionsTimeout60000 ms ou mais para prompts longos
Configurações do nó (ícone de engrenagem)Retry On FailAtivado
Configurações do nóMax. Tries3
Configurações do nóWait Between Tries (ms)5000 ou mais
Nó Loop Over ItemsBatch SizeLotes 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.

ProvedorModelos gratuitosMáx. req/minMáx. req/diaMáx. tokens/minTokens/mês (um modelo)Modelo gratuito mais forte
ElectronHub84---$0.25/week shared recurring creditQwen3.8 Flash (ElectronHub)
qwen3.8-flash
Cloudflare Workers AI39---~5-10MQwen 3.8 27B (Cloudflare Workers AI)
@cf/qwen/qwen3.8-27b
Inferbase38---5,000 requests/month; 100 requests and $0.50 usage/day sharedDeepSeek V4 Flash (fp8) (Inferbase)
deepseek-v4-flash:fp8
AI Horde31---Ongoing volunteer queue; availability variesGemma 4 31B Heretic (AI Horde)
koboldcpp/gemma-4-31B-it-heretic
ACLIDE29---€20/month shared internal usage credits · no cardQwen3.8 Max (ACLIDE)
qwen/qwen3.8-max:free
Google AI Studio21151,000250,000~3MGemini 3.8 Flash
gemini-3.8-flash
Api.Airforce2011,000-free · 1,000 req/day · 1 req/mingpt-oss-20b (Api.Airforce)
gpt-oss-20b
NVIDIA NIM1940--free · 40 RPMGLM 5.3 Flash (NV)
z-ai/glm-5.3-flash
Cohere172033-~1-2MCommand A+ (05-2026)
command-a-plus-05-2026
DreamPrompting141005,000-free · 500K tokens/day · 5,000 req/dayGemini 3.1 Flash-Lite
google/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: Authorization com o valor Bearer <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

ProblemaCausaSolução
O teste da credencial falha com erro de conexãolocalhost aponta para o contêiner do n8nUse host.docker.internal ou uma rede Docker compartilhada
Erro 401Chave erradaCole a chave unificada novamente
A lista de modelos tem centenas de entradasO modo de lista lê o catálogo completoUse o modo ID e digite auto
O agente responde, mas nunca usa uma ferramentaO modelo selecionado não oferece suporte à chamada de ferramentasUse um modelo da tabela acima ou um perfil com modelos que suportam chamada de ferramentas
Erro 429 em um loop longoTodas as chaves atingiram o limiteAdicione provedores, use lotes menores e ative Retry On Fail
O nó excede o tempo limiteUm modelo gratuito lento com um prompt longoAumente o Timeout ou use auto:fast
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

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

Fontes

Todos os guias · Ver todos os modelos gratuitos