Está vendo erro 401 no n8n ao tentar usar AI Agent? Este tutorial passo a passo resolve todas as permissões necessárias da conta OpenAI para workflows n8n sem complicações.

Passo 1: Verificar Status da Conta OpenAI (3 minutos)

1.1 Acessar Billing

Acesse https://platform.openai.com/account/billing

Billing deve estar ativo com saldo > US$5
Se aparecer "No payment method", clique em Add payment method e adicione cartão válido

⚠️ Screenshot Importante

Billing ativo = ✅ | Sem billing = ❌ erro 401

Passo 2: Navegar para API Keys com Permissões Corretas

2.1 Acessar API Keys

Acesse platform.openai.com/api-keys

Requisito mínimo: Ver botão "Create new secret key"

Se não aparecer → Owner precisa ativar "API access" em Settings → Members

Passo 3: Teste Mínimo de Permissões no n8n

Crie workflow exato abaixo:

Manual Trigger → OpenAI Node

3.1 Config OpenAI Node

Resource: Chat
Model: gpt-4o-mini
Credential: [sua key]
Messages:
[ {"role": "user", "content": "Teste n8n OpenAI"} ]

3.2 Validar Resultado

Execute Node → Sucesso: JSON com choices[0].message.content
Falha 401: Recriar key ou verificar billing

Passo 4: Permissões para LangChain Nodes (AI Agent, Embeddings)

4.1 Permissões Necessárias

✓ Chat Completions (gpt-4o)
✓ Embeddings (text-embedding-3-small)
✓ Assistants API (se usar)

NÃO precisa: Admin roles, fine-grained scopes, enterprise seats

AI Agent Node → Chat Model: OpenAI ✓ Chat Completions (gpt-4o) ✓ Embeddings (text-embedding-3-small) ✓ Assistants API (se usar)

Passo 5: Configuração para Projetos Separados (Recomendado)

5.1 Criar Projeto Isolado

platform.openai.com/projects → New Project "n8n-prod"
Dentro do project → Create API Key "n8n-agents"
n8n Credential → Organization ID: [project-org-id]

✅ Benefício

Rate limits isolados por project

Código: Workflow JSON Exportável para Teste

{ "nodes": [ { "parameters": { "jsCode": "return [{json: {teste: 'ok'}}]" }, "type": "n8n-nodes-base.code", "name": "Preparar Teste" }, { "parameters": { "resource": "chat", "model": "gpt-4o-mini", "messages": { "values": [ {"role": "user", "content": "n8n OpenAI funcionando?"} ] } }, "type": "n8n-nodes-base.openAi", "name": "Test OpenAI" } ] }

Checklist Final Permissões

☑ Billing ativo (US$5+)
☑ API Keys visível
☑ Key testada no n8n OpenAI node
☑ AI Agent com mesma credencial OK
☑ Project separado (opcional)

Próximo passo: Guia AI Agent n8n

Tutorial Completo: Permissões OpenAI para n8n - Configuração Zero Erro