OpenAI / ChatGPT API | N8N Academy

🎯

Visão Geral

A API da OpenAI permite integrar os modelos mais avançados de IA nos seus workflows. Desde chat (GPT-4) até geração de imagens (DALL-E) e transcrição de áudio (Whisper).

💬

Chat/Completions

GPT-4, GPT-4o, GPT-3.5

🎨

DALL-E

Geração de imagens

🎤

Whisper

Transcrição de áudio

📊

Embeddings

Vetores semânticos

Obter API Key

1.1 Criar Conta e Adicionar Créditos

1. Acesse platform.openai.com
2. Crie uma conta ou faça login
3. Vá em Settings → Billing
4. Adicione um método de pagamento e créditos

💰 A OpenAI cobra por uso (tokens). GPT-4o custa ~$2.50/1M tokens de input e ~$10/1M tokens de output.

1.2 Gerar API Key

1. Vá em API Keys (menu lateral)
2. Clique em "Create new secret key"
3. Dê um nome: n8n-production
4. Copie a key imediatamente (só aparece uma vez!)

⚠️ IMPORTANTE - Segurança da Key

→ A key só é mostrada UMA VEZ - copie e guarde!
→ NUNCA compartilhe ou commite em código
→ Configure limites de uso em Settings → Limits
→ Use keys diferentes para dev/prod

Configurar no N8N

2.1 Criar Credencial

1. No N8N, vá em Credenciais → Adicionar
2. Pesquise: "OpenAI"
3. Cole sua API Key (começa com sk-...)
4. Clique em Salvar

2.2 Nodes Disponíveis

OpenAI

Chat, completions, análise

OpenAI Chat Model

Para uso com AI Agent

OpenAI Embeddings

Vetorização de texto

AI Agent

Agentes autônomos com tools

🧠

Modelos Disponíveis

💬 Chat/Text (Recomendados)

Modelo	Contexto	Melhor para	Custo
gpt-4o	128K tokens	Melhor custo-benefício	$$$
gpt-4o-mini	128K tokens	Tarefas simples, baixo custo	$
gpt-4-turbo	128K tokens	Raciocínio complexo	$$$$
gpt-3.5-turbo	16K tokens	Legado, mais barato	$
o1-preview	128K tokens	Raciocínio avançado	$$$$$

🎨 Imagens & 🎤 Áudio

DALL-E 3

Geração de imagens HD. ~$0.04/imagem

Whisper

Transcrição de áudio. ~$0.006/minuto

TTS (Text-to-Speech)

Gerar áudio a partir de texto

text-embedding-3-large

Embeddings para RAG/busca

📋

Exemplos Práticos

💬 Chat Simples

// Node: OpenAI
// Operation: Message a Model

Model: gpt-4o-mini
Messages:
  - Role: system
    Content: Você é um assistente útil.
  - Role: user
    Content: {{ $json.pergunta }}

// Resposta em:
{{ $json.message.content }}
          

📊 Classificar Texto

// Classificar sentimento de feedback

System Prompt:
  Classifique o sentimento do texto
  em: positivo, negativo ou neutro.
  Responda APENAS com a classificação.

User:
  {{ $json.feedback }}

// Resposta: "positivo"
          

📝 Extrair Dados Estruturados

// Extrair dados de email

System:
  Extraia os dados do email em JSON:
  {
    "nome": "",
    "email": "",
    "assunto": "",
    "urgencia": "alta|media|baixa"
  }

User: {{ $json.email_body }}

// Use JSON.parse() na resposta
          

📰 Resumir Conteúdo

// Resumir artigo/documento

System:
  Resuma o texto em 3 bullet points
  principais. Seja conciso e objetivo.

User:
  {{ $json.artigo }}

// Parâmetros recomendados:
Temperature: 0.3
Max Tokens: 300
          

🎨 Gerar Imagem (DALL-E)

// Node: OpenAI
// Operation: Generate Image

Model: dall-e-3
Prompt:
  Um gato programador usando óculos,
  trabalhando em um laptop,
  estilo cartoon colorido

Size: 1024x1024
Quality: standard

// Retorna URL da imagem
          

🎤 Transcrever Áudio (Whisper)

// Node: OpenAI
// Operation: Transcribe Audio

Model: whisper-1
Audio File: {{ $binary.data }}
Language: pt  // opcional

// Retorna texto transcrito
// Suporta: mp3, mp4, mpeg, mpga,
// m4a, wav, webm
          

🤖

AI Agent com Tools

O que são AI Agents?

Agents são modelos de IA que podem usar ferramentas (tools) para executar ações. O modelo decide quando e qual ferramenta usar baseado no contexto.

🔧

Tools

Workflows como ferramentas

🧠

Memória

Contexto persistente

📚

RAG

Conhecimento externo

Exemplo: Agent com Tool de Busca

// Estrutura do Workflow:
//
// [Chat Trigger] → [AI Agent] ← [OpenAI Chat Model]
//                      ↑
//                   [Tool: HTTP Request]
//                   (buscar dados de API)

// Configuração do AI Agent:
System Message:
  Você é um assistente que pode buscar
  informações sobre o clima.
  Use a tool "buscar_clima" quando
  perguntarem sobre tempo/temperatura.

// A Tool é um subworkflow que:
// 1. Recebe cidade como input
// 2. Faz request para API de clima
// 3. Retorna dados formatados

// O Agent automaticamente:
// 1. Identifica a intenção
// 2. Chama a tool apropriada
// 3. Formata a resposta final
        

💡

Boas Práticas

✅ Faça

→ Use system prompts claros e específicos
→ Ajuste temperature (0 = determinístico, 1 = criativo)
→ Use gpt-4o-mini para tarefas simples (10x mais barato)
→ Limite max_tokens para controlar custo
→ Use JSON mode para outputs estruturados
→ Implemente retry com exponential backoff

❌ Evite

→ Enviar dados sensíveis desnecessariamente
→ Prompts vagos ou ambíguos
→ Ignorar rate limits (causa erros 429)
→ Usar modelos caros para tarefas simples
→ Confiar cegamente nas respostas
→ Não tratar erros de API

💰 Dicas de Custo

// 1. Use modelos apropriados:
// - Classificação simples → gpt-4o-mini
// - Análise complexa → gpt-4o
// - Raciocínio avançado → o1-preview

// 2. Limite tokens:
max_tokens: 500  // Suficiente para maioria das tarefas

// 3. Cache respostas:
// Use Redis ou banco de dados para cachear
// respostas de perguntas frequentes

// 4. Monitore uso:
// Settings → Usage no dashboard OpenAI
        

🔧

Troubleshooting

❌ "Insufficient quota" / Error 429

Causa: Sem créditos ou rate limit excedido.

Solução: Adicione créditos em Billing ou aguarde reset do rate limit (geralmente 1 minuto).

❌ "Invalid API key"

Causa: Key incorreta ou revogada.

Solução: Verifique a key no dashboard. Gere uma nova se necessário.

❌ "Context length exceeded"

Causa: Prompt + resposta excedem limite do modelo.

Solução: Reduza o prompt, use modelo com mais contexto (128K), ou implemente chunking.

❌ Resposta vazia ou cortada

Causa: max_tokens muito baixo ou finish_reason = "length".

Solução: Aumente max_tokens ou verifique o finish_reason na resposta.

OpenAI Configurado!

Agora você pode adicionar IA aos seus workflows.

Ver Outros LLMs (DeepSeek, Mistral) → Ver Todas as Conexões