n8n com ChatGPT: como usar a API da OpenAI nos fluxos
Veja como usar o ChatGPT no n8n pela API da OpenAI: criar a chave, cadastrar a credencial, montar o primeiro fluxo e evitar os erros comuns.
Por Redação Eleven Host · @robson.direitodigital · 28 de outubro de 2026 · 6 min de leitura
Capa da Redação Eleven Host para o guia: n8n com ChatGPT: como usar a API da OpenAI nos fluxos Arte: Eleven Host
Para usar o n8n com ChatGPT, você usa a API da OpenAI por meio do nó OpenAI: crie a chave, cadastre a credencial e monte o fluxo. A API é cobrada à parte da assinatura do ChatGPT.
Este guia mostra o caminho completo: a diferença entre o app e a API, como criar a chave e a credencial, o que o nó OpenAI faz, um primeiro fluxo com webhook, o agente de IA, os erros que a documentação do n8n lista e os cuidados com a chave, os custos e os dados. Ele parte de um n8n já instalado; se ainda não tem, veja o guia Instalar n8n na VPS: passo a passo com Docker.
ChatGPT e API da OpenAI são coisas diferentes
O app ChatGPT (no site e no celular) e a API da OpenAI são produtos separados. A central de ajuda da OpenAI diz que o ChatGPT e a plataforma de API têm cobrança separada e que a assinatura do ChatGPT não inclui o uso da API.
O n8n conversa com a API, e a API tem a sua própria conta na plataforma da OpenAI. O uso da API é pago conforme o modelo escolhido e o volume de texto processado, medido em tokens. Consulte a página de preços da OpenAI antes de ativar um fluxo.
Criar a chave e a credencial no n8n
Segundo a documentação do n8n, a credencial da OpenAI funciona por chave de API (API key). Siga estes passos:
- Entre na plataforma da OpenAI, ou crie uma conta.
- Vá até a página de chaves de API, no endereço platform.openai.com/api-keys.
- Crie uma nova chave secreta. O nome é opcional, mas ajuda a lembrar para que ela serve.
- Copie a chave.
- No n8n, crie uma credencial do tipo OpenAI e cole a chave no campo API Key.
Existe também o campo Organization ID. Ele só é necessário se você participa de mais de uma organização na OpenAI. Se for o seu caso, informe-o; se não, deixe em branco.
O que o nó OpenAI faz
O nó OpenAI reúne várias operações, que aparecem no n8n com nomes em inglês. Segundo a documentação, elas se dividem assim:
- Texto: Generate a Chat Completion, Generate a Model Response e Classify Text for Violations.
- Imagem: Analyze Image, Generate an Image e Edit an Image.
- Áudio: Generate Audio, Transcribe a Recording e Translate a Recording.
- Arquivo: Upload, List e Delete a File.
- Vídeo: Generate a Video.
- Conversa: Create, Get, Update e Remove a Conversation.
Entre os usos possíveis estão resumir e-mails, classificar pedidos e transcrever áudio.
A versão V2 do nó existe a partir do n8n 1.117.0 e usa a Responses API, deixando de usar a Assistants API. Se o seu n8n é mais antigo, o guia Atualizar n8n no Docker: passo a passo com backup mostra como atualizar com backup. Se faltar uma operação no nó, a documentação indica usar o nó HTTP Request com a credencial da OpenAI.
A chave da OpenAI é secreta. Ela fica só na credencial do n8n: não a coloque num nó Code, numa planilha nem num print de tela.
Primeiro fluxo: webhook, OpenAI e resposta
Um fluxo simples para testar tem três nós:
- Webhook: recebe um texto. O guia Webhook no n8n: como criar, testar e colocar no ar explica como criar e testar o gatilho.
- OpenAI: use a operação Generate a Model Response. Na mensagem, use uma expressão que pegue o texto recebido.
- Respond to Webhook: devolve ao chamador a resposta do modelo.
No campo da mensagem do nó OpenAI, a expressão que lê o campo texto do corpo do webhook é:
{{ $json.body.texto }}
A expressão lê o campo texto dentro de body. O nome texto é um exemplo: use o nome do campo que você enviar.
Teste o passo antes de ativar o fluxo. Execute o webhook, envie um texto de exemplo e confira se o nó OpenAI devolveu uma resposta. Só depois ative o fluxo.
Quer um n8n para montar seus fluxos? Os planos saem a partir de R$ 19,90/mês no n8n Essencial; confira na loja o que cada plano inclui. Ver planos de n8n
Agente de IA: quando o modelo decide o que usar
Além do nó OpenAI, o n8n tem o nó AI Agent. Segundo a documentação, você conecta a ele um modelo de chat e uma ou mais ferramentas, e o agente decide quais ferramentas usar. O nó precisa de pelo menos uma ferramenta conectada.
No nó OpenAI, só duas operações aceitam ferramentas (tools): Generate a Chat Completion e Generate a Model Response. As outras não aceitam.
Para um primeiro contato, comece pelo fluxo de três nós da seção anterior. Passe para o agente quando quiser que a IA escolha entre as ferramentas que você conectar.
Erros comuns e o que fazer
A documentação do n8n lista quatro problemas frequentes com o nó OpenAI:
- Muitas requisições: a mensagem é The service is receiving too many requests from you. A saída indicada é dividir o trabalho em lotes, com o nó Loop Over Items e um nó Wait entre os lotes.
- Cota insuficiente: indica conta sem créditos ou limite atingido. Confira a organização e o projeto, o saldo e os limites, e se a chave é válida e está ligada ao nó certo. Depois de uma recarga, pode demorar um pouco a refletir. Se persistir, gere uma chave nova.
- Bad request - please check your parameters: repita a chamada com o nó HTTP Request para ver o erro detalhado.
- An expression references the node ... but it hasn't been executed yet: a expressão usa um nó que ainda não rodou. Teste o fluxo até aquele nó.
Cuidados com a chave, custos e dados
Antes de ativar o fluxo, pense em três pontos:
- Chave: mantenha-a só na credencial do n8n, como no destaque acima.
- Custos: a documentação cita limites de organização e de projeto na OpenAI. Defina limites de uso no projeto da OpenAI.
- Dados: o texto que o fluxo envia vai para a OpenAI. Evite mandar dado pessoal de clientes sem necessidade, por causa da LGPD.
Teste com poucos exemplos antes de ativar o fluxo e confira o que ele enviou e recebeu.
Checklist antes de ativar
- Tenho conta na plataforma da OpenAI, separada da assinatura do ChatGPT.
- Criei a chave e a coloquei só na credencial do n8n.
- Defini limites de uso no projeto da OpenAI.
- Conferi se o meu n8n tem a versão necessária para o nó V2.
- Testei o passo do nó OpenAI com um texto de exemplo.
- Testei o fluxo inteiro antes de ativar.
- Não envio dado pessoal de cliente sem necessidade.
- Sei o que fazer se aparecer o erro de muitas requisições ou de cota.
Pronto para automatizar? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n
Perguntas frequentes
A assinatura do ChatGPT serve para usar no n8n?
Não. Segundo a central de ajuda da OpenAI, a assinatura do ChatGPT não inclui o uso da API. O n8n usa a API, que tem cobrança separada.
Preciso criar uma chave de API?
Sim. Segundo a documentação do n8n, a credencial da OpenAI funciona por chave de API, criada na plataforma da OpenAI.
O n8n usa a Assistants API?
A versão V2 do nó, disponível a partir do n8n 1.117.0, usa a Responses API e deixou a Assistants API.
Quando devo usar o nó AI Agent?
Quando você quer que a IA escolha entre ferramentas. O nó exige pelo menos uma ferramenta conectada. Para resumir um texto, por exemplo, dá para usar o nó OpenAI.
