n8n com Claude e GPT: configurar uma Base URL própria

O n8n é uma ferramenta de automação de fluxos de trabalho que você pode hospedar por conta própria ou usar como n8n Cloud. Os recursos de IA são montados com nós raiz como AI Agent e Basic LLM Chain. Cada um tem um conector Chat Model, e o subnó de modelo ligado ali define qual API é chamada.

O nó de modelo pega o endereço e a chave de uma credencial. Na versão atual do n8n (conferido no código-fonte e na documentação do n8n em outubro de 2026), tanto a credencial OpenAI quanto a credencial Anthropic têm um campo Base URL. Isso basta: sem nós da comunidade e sem gambiarras com HTTP Request. Todo fluxo que usa essa credencial consome seu saldo na APIVAI, com cobrança por token. Se você também cria aplicativos de chat no Dify, a mesma chave funciona lá: veja Dify com Claude e GPT.

A maioria deve começar pela credencial OpenAI. Adicione a da Anthropic depois, se tiver fluxos com Claude que enviam um prompt de sistema longo e repetido, em que o cache de prompt reduz o custo de entrada. Os detalhes gerais dos dois formatos estão em API compatível com OpenAI e proxy da API do Claude.

1. Cadastre-se com seu e-mail
2. Recarregue o saldo, a partir de $10, com cartão, cripto, Alipay ou WeChat Pay
3. Crie uma chave no Painel e copie. Você pode dar à chave um limite de orçamento próprio, o que é útil para automações que rodam sem supervisão.

1. Abra um fluxo e adicione um nó AI Agent (ou um Basic LLM Chain).
2. Clique em + abaixo de Chat Model e escolha OpenAI Chat Model.
3. Em Credential to connect with, escolha Create new credential.
4. Preencha os campos:

1. Clique em Save. O n8n testa a credencial pedindo /models ao Base URL. Se o teste passar, a chave e o endereço estão certos.

• Model: abra a lista e escolha um modelo. O n8n carrega a lista da APIVAI, então você vê os IDs que sua chave pode usar. Você também pode mudar o campo de From List para ID e digitar um ID como claude-sonnet-4-6.
• Use Responses API: as versões recentes do nó deixam isso ligado por padrão. A APIVAI suporta a Responses API, então dá para manter ligado com modelos GPT. Com modelos Claude, desligue para o nó usar Chat Completions. Deixe Built-in Tools vazio e dê ao agente nós de ferramentas do n8n.
• Options → Maximum Number of Tokens: se definir um limite, use 4096 ou mais. O raciocínio (thinking) vem ligado por padrão e conta como saída, então um limite pequeno pode gerar resposta vazia ou cortada.

1. Em Chat Model, escolha Anthropic Chat Model e crie uma nova credencial.
2. Coloque sua chave da APIVAI em API Key e, em Base URL:

Não acrescente /v1. O teste da credencial chama /v1/models e o nó envia as requisições para /v1/messages, ambos somados a esse endereço.

1. No nó, escolha o modelo na lista ou mude para ID e digite.
2. Em Options, mantenha Maximum Number of Tokens em 4096 ou mais. Use Prompt Caching (5 Minutes ou 1 Hour) quando um fluxo envia muitas vezes o mesmo prompt de sistema longo; em 2026-10-07, a leitura de cache do Claude Sonnet 4.6 custa $0.10 por 1M de tokens. Deixe Thinking Mode sem definir para manter o padrão do modelo.

Adicione um gatilho When chat message received antes do agente, abra o painel de chat e envie uma mensagem curta. Quando o agente responder, a requisição aparece com seus tokens e custo no Painel da APIVAI.

Preços por 1M de tokens de entrada / saída em 2026-10-07:

Um padrão prático: rode as etapas baratas, como roteamento, marcação e extração de dados, com Claude Haiku 4.5 ou GPT-6 Luna, e deixe um modelo Sonnet só para o agente que precisa planejar e chamar ferramentas. Cada nó pode usar um modelo diferente com a mesma credencial.

A lista de modelos muda com o tempo. Pegue os IDs na página de preços ou pergunte direto à API:

Automações são fáceis de estimar porque repetem um prompt com a mesma forma muitas vezes. Dois exemplos, com os tokens de raciocínio contados como saída:

• Triagem de e-mail: um fluxo classifica 200 e-mails recebidos por dia com o Claude Haiku 4.5, cerca de 2.000 tokens de entrada e 500 de saída cada. Um mês de 6.000 requisições custa $9.42, contra $27.00 a preços oficiais.
• Agente de suporte: um AI Agent com Claude Sonnet 4.6 responde 50 chamados por dia e faz cerca de 5 chamadas ao modelo por chamado (incluindo chamadas de ferramentas), cada uma com uns 6.000 tokens de entrada e 800 de saída. São 7.500 chamadas por mês: $78.12, contra $225 a preços oficiais.

Agentes custam mais que chamadas avulsas porque cada etapa reenvia a conversa e os resultados das ferramentas. Acompanhe o Painel por um dia e depois ajuste o modelo de cada nó. Uma comparação de preços mais ampla está em Preços da API do Claude em 2026.

Só na parte de chat. A APIVAI não oferece embeddings, então o subnó Embeddings de um vector store precisa de um provedor de embeddings separado. O agente que responde com base no texto recuperado continua podendo usar um modelo de chat da APIVAI.

• O teste da credencial falha ou dá 401: confira se a chave foi copiada inteira, se ainda existe e se ainda há saldo ou orçamento. Na credencial Anthropic, a chave deve estar em API Key.
• 404: o /v1 está errado. A credencial OpenAI precisa exatamente de https://api.apivai.com/v1, com /v1 uma única vez. A credencial Anthropic precisa de https://api.apivai.com sem /v1; com /v1, as requisições vão para /v1/v1/messages.
• Model not found: o n8n informa que o modelo não foi encontrado no seu Base URL. Use o ID exato, como claude-sonnet-4-6, e não um nome de exibição, e pegue-o em /v1/models.
• Respostas vazias ou cortadas: aumente Maximum Number of Tokens para 4096 ou mais; os tokens de raciocínio usam parte do limite.
• Erros com um agente Claude na credencial OpenAI: desligue Use Responses API no nó OpenAI Chat Model e tente de novo.
• 429 Too Many Requests: o limite padrão é de 60 requisições por minuto por chave. Processe os itens em lotes menores, defina Max Retries nas opções do nó ou Retry On Fail nas configurações do nó, ou peça ao suporte para aumentar o limite.

Não. As credenciais nativas da OpenAI e da Anthropic têm um campo Base URL, então os nós de modelo padrão funcionam.

Sim, os campos da credencial são os mesmos. Uma instância auto-hospedada precisa de acesso de saída à internet para api.apivai.com.

Sim. Uma chave da APIVAI funciona com todos os modelos, tanto na credencial OpenAI quanto na credencial Anthropic.

Crie uma chave separada para o n8n e dê a ela um limite de orçamento no Painel. Quando o orçamento acaba, as requisições com essa chave param em vez de esvaziar seu saldo. A documentação explica chaves e limites.

O conteúdo das requisições e respostas não é registrado. Só ficam guardados dados de uso, como modelo, tokens e custo, para a cobrança.

Crie uma conta, recarregue a partir de $10 e cole sua chave no n8n.