Custo da API de IA do n8n: uma execução, muitas chamadas de modelo, duas cobranças

O n8n cobra uma vez por execução de workflow; sua API de modelo de IA cobra por cada chamada de modelo dentro dessa execução. São dois medidores separados, e apenas o primeiro tem uma cota. A própria definição do n8n não deixa margem: "Uma execução é uma única execução de todo o seu workflow. Não importa quantas etapas existam no workflow ou quantos dados ele processe" (página de preços do n8n, verificada em 19 de setembro de 2026). Um nó AI Agent dentro dessa única execução pode fazer, por padrão, até dez viagens de ida e volta ao modelo, e o nó OpenAI Chat Model tenta novamente uma chamada com falha duas vezes — portanto, uma única execução que vale 1/2.500 da cota de um plano Starter pode conter até aproximadamente trinta chamadas de modelo faturadas.

Uma desambiguação antes dos números, pois a consulta se divide em três sentidos. A API REST pública do n8n — a que lista e aciona workflows — não tem preço publicado por chamada; o que a documentação do n8n informa é que ela não está disponível durante o teste gratuito e solicita que você faça upgrade (documentação da API do n8n). Um plano do n8n é cobrado por execuções e é tratado abaixo apenas como a cobrança contrastante. Os tokens de modelo consumidos pelos seus workflows são o assunto desta página. O n8n está ativo e não teve seu nome alterado: esta página lê seu comportamento na versão n8n@2.39.8, publicada em 18 de setembro de 2026, e versões mais recentes foram lançadas desde então (versões do GitHub).

Medidor um: o que uma execução do n8n contabiliza

A contabilidade das execuções é o motivo pelo qual as duas cobranças evoluem de forma independente. Um workflow com cem nós e um workflow com dois nós custam uma execução cada. O que varia é quais execuções são contabilizadas.

As seis regras são citadas da documentação de execuções do n8n, verificada em 19 de setembro de 2026. Uma questão que essa página não resolve, portanto não é afirmada aqui: se uma nova tentativa manual de uma execução com falha é contabilizada. Ela resolve o caso próximo — um gatilho de agenda é contabilizado "independentemente do resultado", e uma solicitação de webhook malformada que falha antes do início do workflow não é contabilizada. Observe também que as cotas não são um conceito exclusivo do Cloud — a mesma página afirma que os planos pagos, na nuvem ou auto-hospedados, têm uma cota-limite de execuções.

O exemplo de dimensionamento que o n8n publica nas perguntas frequentes da sua página de preços é útil: uma agenda diária produz 30 ou 31 execuções por mês, enquanto uma execução a cada cinco minutos produz cerca de 8.600 a 8.900. A mesma FAQ informa que o histórico de execuções salvas tem limites separados — por quantidade, por armazenamento no Cloud e por uma janela de retenção — e que atingir um desses limites não interrompe a execução dos workflows; apenas reduz o histórico mantido. É importante manter isso claro, pois os limites do histórico são confundidos com limites de gastos.

Da página de preços do n8n e da página do plano Startup, verificadas em 19 de setembro de 2026. Três ressalvas que esta página não vai encobrir. Os preços mensais sem cobrança anual não são renderizados no servidor nessa página, portanto nenhum valor mensal é citado aqui. Os preços fornecidos a esta verificação estavam em euros e podem ser resolvidos por geolocalização; confirme sua própria moeda no checkout. E a resposta sobre excedentes na FAQ de preços do n8n é escrita para Business e Enterprise — nem essa página nem a página do plano Startup informam o que acontece no Starter ou Pro quando a cota de execuções se esgota.

Medidor dois: a cobrança do modelo e os padrões que a multiplicam

A fórmula é simples, e é nos padrões que o dinheiro vai embora:

cost = production executions × model calls per execution × (input tokens × input rate + output tokens × output rate)

O termo intermediário é aquele que ninguém inclui no orçamento, porque a cobrança do n8n nunca o mostra. Cada valor abaixo foi lido do código-fonte publicado na tag n8n@2.39.8, não da documentação.

Fontes, todas lidas em 19 de setembro de 2026: as opções do Tools Agent do agente, o nó OpenAI Chat Model, o nó Anthropic Chat Model e o nó Embeddings OpenAI. Dez iterações vezes três tentativas é um teto, não uma execução típica — mas é um teto que custa trinta chamadas de modelo e ainda aparece como uma única execução no seu plano do n8n.

Uma estimativa prática do custo da API de IA do n8n

Estes são cálculos ilustrativos de tokens, não custos medidos de workflows nem um teto de cobrança. Considere uma execução de AI Agent que faça três viagens de ida e volta ao modelo — bem abaixo do limite padrão de dez —, cada uma enviando 6,000 tokens de entrada (prompt do sistema, esquemas de ferramentas e um scratchpad que cresce a cada rodada) e recebendo 350 tokens de saída. As tarifas são preços ativos do catálogo da Kunavo por milhão de tokens; as colunas de cota simplesmente multiplicam pelas permissões de execução Starter e Pro para colocar os dois medidores lado a lado.

Duas leituras. Primeiro, a diferença entre as linhas superior e inferior sob estas premissas é maior que toda a taxa do plano n8n, motivo pelo qual discutir Starter contra Pro antes de escolher um modelo significa discutir o número menor. Segundo, o teto de iterações é a verdadeira variação: a mesma execução Claude Sonnet 5 modelada a $0.0325 para três chamadas passa a custar $0.3255 se executar as dez iterações completas com cada chamada repetida duas vezes — dez vezes o custo, sem qualquer alteração na sua contagem de execuções do n8n. No Claude Haiku 4.5, essa mesma execução de três chamadas é modelada a $0.0163.

Dimensione pelas suas próprias execuções por dia antes de tratar qualquer destes valores como orçamento. O valor do catálogo da Kunavo é um piso de cobrança, não um teto: quando o upstream informa sua cobrança, a fatura é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pelo markup aplicável. As cobranças de cache e as ferramentas externas ficam fora deste exemplo. O recarregamento mínimo da Kunavo é de $10 em crédito pré-pago, o que representa um mínimo de financiamento, não uma assinatura ou uma taxa por tarefa — consulte detalhes de cobrança.

Os "créditos de IA" do n8n não são seu orçamento para modelos

Este é o erro mais repetido em textos publicados sobre custos do n8n, e vale a pena ser direto. O n8n documenta três saldos de créditos diferentes, e aquele anunciado na página de preços não é o que paga pelas chamadas de modelo dos seus workflows.

As duas primeiras colunas são citadas da documentação de créditos do Gateway do n8n, verificada em 19 de setembro de 2026; o escopo de planos dos créditos do Assistant vem da FAQ da página de preços, que informa que o AI Assistant está incluído em todos os planos n8n Cloud, exceto Enterprise, e que créditos não utilizados não são acumulados. Discussões da comunidade sobre "créditos OpenAI gratuitos no n8n" descrevem o terceiro saldo legado e não devem ser interpretadas como atuais.

Os créditos do Gateway são uma conveniência real: o n8n roteia as solicitações do nó pelo próprio gateway, autenticando-se com o provedor em nome do n8n, portanto um workflow executa um nó de modelo sem nenhuma conta de provedor. De acordo com a página Usar créditos do Gateway do n8n, um nó alterna entre "Usar créditos do Gateway" e "Usar minha própria credencial" em um único seletor, sem reconstruir o workflow — embora, nos nós em que apenas parte da funcionalidade seja compatível, as operações incompatíveis fiquem ocultas enquanto os créditos do Gateway estiverem selecionados.

Esta página não pode fornecer uma comparação numérica entre créditos do Gateway e Kunavo, e ninguém fora de um login do Cloud pode fazê-lo. O n8n publica suas tarifas de gateway somente em app.n8n.cloud/service-pricing, atrás de autenticação, e informa que as tarifas variam conforme o modelo e o serviço. Não existe conversão publicada de créditos para dólares. Qualquer artigo que mostre essa tabela a você a construiu com base em algo que não é uma fonte. O que pode ser comparado é a estrutura:

Cada linha vem da mesma documentação de créditos do Gateway e da sua página de recarga. A consequência prática: se você hospeda o n8n por conta própria, os créditos do Gateway não existem para você, e usar sua própria chave não é uma preferência, mas o único caminho.

Qual rota vence e quando

Uma observação sobre orçamento que se aplica às três linhas de uso da sua própria conta: o n8n não oferece nenhum limite de gastos para chamadas de modelo faturadas fora dele. A cota de execuções limita quantas vezes um fluxo de trabalho é iniciado, não o que acontece dentro dele. (Os créditos do Gateway são a exceção — o próprio saldo chega a zero, e a recarga automática aceita um limite mensal opcional.) Se você quiser um teto rígido, ele precisa vir do lado do provedor — um saldo pré-pago que simplesmente para quando se esgota é a versão mais direta e confiável disso. Otimização de custos de IA cobre o restante do método, e o diretório de APIs de agentes de IA mostra como o n8n fica ao lado dos outros clientes que usam um endpoint personalizado.

Conectando um endpoint de terceiros ao n8n

O n8n não inclui nenhum nó de modelo genérico "compatível com OpenAI". O nó OpenAI junto com uma Base URL da credencial é o caminho genérico, e o erro mais comum nos tutoriais é procurar esse campo no lugar errado.

A Base URL fica na credencial, não no nó. No código-fonte lançado, a opção Base URL dentro do nó OpenAI Chat Model fica oculta na versão 1.1 do nó e superiores, e a do nó Embeddings fica oculta a partir da 1.2 — portanto, em qualquer nó que você adicionar hoje, a substituição dentro do nó fica invisível e a credencial é o único lugar onde ela existe. Nem a página de credenciais OpenAI do n8n nem a página de credenciais Anthropic documenta o campo, mas ambas as credenciais o carregam no código-fonte.

Credential type:  OpenAI  (used by the "OpenAI Chat Model" sub-node)
API Key:          sk-kn-…            # your Kunavo key
Base URL:         https://api.kunavo.com/v1

# Then in the OpenAI Chat Model node:
Model:            ID mode -> claude-sonnet-5
Options > Built-in Tools:   leave OFF on a non-OpenAI endpoint

Um conflito entre o código-fonte e a documentação que você deve conhecer. A documentação do nó do n8n diz que o nó OpenAI Chat Model usa por padrão a API Chat Completions. O código-fonte lançado em n8n@2.39.8 diz o contrário: responsesApiEnabled tem default: true na versão 1.3 do nó e superiores, portanto um nó recém-adicionado publica em /v1/responses, não em /v1/chat/completions. Ambos são mostrados aqui em vez de escolher um silenciosamente; o comportamento segue o código distribuído, e um endpoint que implemente apenas chat completions falhará imediatamente até que essa opção seja desativada. A rota /v1/responses da Kunavo aceita todos os modelos de chat habilitados, assim como /v1/chat/completions, portanto o endpoint padrão do nó é um que existe aqui, em vez de um que retorna 404 — embora nenhum fluxo de trabalho tenha sido executado de ponta a ponta para confirmar a ida e volta. Consulte a documentação da API de chat e o guia da API compatível com OpenAI.

Três limites que vale a pena conhecer antes de começar a criar.

Também deixe as Built-in Tools do nó OpenAI desativadas em um endpoint personalizado. Web Search, File Search e Code Interpreter são esse conjunto no código-fonte lançado; Conversation ID, Prompt Cache Key e Service Tier ficam ao lado dele nas Options do nó. Todos os seis são recursos da plataforma OpenAI; nenhum deles foi verificado para funcionar por meio da Kunavo e, para modelos traduzidos para chat, eles não podem funcionar. O n8n exibe seu próprio aviso no nó exatamente para esta situação: ao usar modelos que não são OpenAI por meio de uma substituição de Base URL, nem todos os modelos podem ser compatíveis com chat ou oferecer suporte a outros recursos, como chamadas de ferramentas ou formato de resposta JSON.

Configure e leia a primeira cobrança

A Kunavo não testou o n8n em tempo de execução. Ainda não há uma página de integração publicada do n8n aqui, e todo comportamento do n8n descrito acima foi lido no código-fonte lançado em n8n@2.39.8 e na própria documentação do n8n — isso é uma referência de configuração, não um teste de compatibilidade. Trate a primeira criação como um teste: mantenha uma rota funcional disponível, execute um fluxo de trabalho limitado com uma pequena contagem de execuções e depois leia a cobrança que sua conta realmente registrou, em vez de estimar com base na tabela acima.

Se você estiver escolhendo entre gateways, e não entre rotas, Alternativas ao OpenRouter e o guia de gateways de LLM abordam essa comparação, e API Claude mais barata trata especificamente da família Claude. Quando estiver pronto para adicionar fundos a uma chave, crie uma conta Kunavo.

Perguntas frequentes

Preços dos planos do n8n, regras de execução, termos dos créditos do Gateway e documentação da API verificados em 19 de setembro de 2026; padrões dos nós e campos das credenciais lidos no código-fonte lançado na tag n8n@2.39.8. O fato de a lista de modelos da Kunavo aceitar a chave como x-api-key, além de um token bearer, foi lido no código de autenticação deste repositório, e a forma como o menu suspenso Anthropic identifica essa lista foi lida no código-fonte do n8n na mesma tag; nenhum dos dois foi medido em relação à API ativa. Nenhum fluxo de trabalho do n8n foi criado ou executado contra a Kunavo. As tarifas de tokens da Kunavo vêm do catálogo ativo, e todos os valores em dólares nesta página são cálculos ilustrativos de tokens, não uma execução medida.