openai-video-generator

n8n node para geração de vídeos com OpenAI Sora API

Package Information

Released: 11 mo ago
Downloads: 2 weekly / 51 monthly
Latest Version: 1.0.2
Author: Thiago D'Arezzo

Documentation

🎬 OpenAI Video Generator - n8n Node

Nó community para n8n - Gere vídeos incríveis com OpenAI Sora!

npm version
License: MIT


✨ Features

  • ✅ Gera vídeos com IA usando OpenAI Sora
  • ✅ Polling automático - aguarda até o vídeo ficar pronto
  • ✅ Download automático do MP4
  • ✅ Múltiplas resoluções - HD, Full HD, Vertical, Horizontal
  • ✅ Logs informativos - acompanhe o progresso
  • ✅ Simples de usar - só descreva o que quer!

🚀 Instalação

No n8n:

  1. Settings → Community Nodes → Install
  2. Digite: n8n-nodes-openai-video-generator
  3. Reinicie o n8n

Ou via npm:

npm install n8n-nodes-openai-video-generator

📋 Pré-requisitos

  1. API Key da OpenAI (obter aqui)
  2. Créditos ou assinatura (Sora não é gratuito)
  3. Acesso ao Sora (pode estar em waitlist)

🎯 Uso Básico

Configurar Credenciais:

  1. No n8n: Credentials → Create New
  2. Tipo: OpenAI Video API (Sora)
  3. API Key: Cole sua chave (sk-proj-...)

Criar Workflow:

Trigger → OpenAI Video Generator

Configuração:

  • Prompt: "A wide tracking shot of a teal coupe driving through a desert highway"
  • Modelo: Sora 2
  • Resolução: 1280x720
  • Duração: 8 segundos
  • Execute!

Aguarde ~2-5 minutos (geração de vídeo é lenta)

Resultado: ✅ Vídeo MP4 pronto para usar!


📊 Modelos Disponíveis

Modelo Qualidade Velocidade Custo
Sora 2 Pro Muito alta Lento Mais caro
Sora 2 Alta Médio Padrão

📐 Resoluções Suportadas

Resolução Formato Uso
1920x1080 Horizontal Vídeos tradicionais
1280x720 Horizontal HD (padrão)
1080x1920 Vertical Stories, Reels
720x1280 Vertical Stories

⏱️ Tempo de Geração

Tempo médio:

  • 4-6 segundos: ~2-3 minutos
  • 8-10 segundos: ~3-5 minutos

Depende de:

  • Modelo escolhido
  • Carga dos servidores da OpenAI
  • Complexidade do prompt

O nó aguarda automaticamente! ✨


💡 Exemplo de Workflow

Gerar vídeo e publicar no Instagram:

┌─────────────────────┐
│ Manual Trigger      │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│ OpenAI Video Gen    │
│ Prompt: "..."       │
│ Size: 1080x1920     │  ← Vertical (Stories/Reels)
│ Seconds: 8          │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│ Write Binary File   │
│ Salvar video.mp4    │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│ Instagram Publish   │
│ Tipo: Reel          │
│ Compartilhar: Sim   │
└─────────────────────┘

Automatização completa! 🚀


📝 Dicas de Prompt

✅ Bom Prompt:

"A wide tracking shot of a teal coupe driving through a desert highway, heat ripples visible, hard sun overhead."

Por quê funciona:

  • ✅ Descreve a cena
  • ✅ Define movimento da câmera
  • ✅ Inclui detalhes visuais
  • ✅ Específico e claro

⚠️ Prompt Ruim:

"Um carro"

Por quê não funciona bem:

  • ❌ Muito vago
  • ❌ Sem contexto
  • ❌ Sem detalhes

💡 Estrutura Ideal:

[Movimento de câmera] + [Cena principal] + [Ambiente] + [Iluminação/Atmosfera]

Exemplos:

  • "Close-up of raindrops falling on a window, city lights blurred in background, soft blue hour lighting"
  • "Drone shot descending over a misty forest, morning sunlight filtering through trees"
  • "Static shot of ocean waves crashing on rocks, golden hour sunset, seagulls flying"

🎨 O que o Nó Retorna

{
  success: true,
  video_id: "video_abc123",
  status: "completed",
  model: "sora-2",
  size: "1280x720",
  seconds: "8",
  prompt: "...",
  video_size_kb: 2048,
  download_url: "https://api.openai.com/v1/videos/video_abc123/content"
}

// + Vídeo em formato binário (MP4) pronto para salvar/usar

⚠️ Limitações

  • ⏱️ Geração é LENTA: 2-5 minutos por vídeo
  • 💰 Não é gratuito: Consome créditos da OpenAI
  • 🔐 Requer acesso: Sora pode estar em waitlist
  • 🌍 Prompt em inglês: Funciona melhor em inglês

🐛 Troubleshooting

Erro: "Invalid API Key"

Solução: Verifique se a API Key está correta

Erro: "Timeout"

Solução: Aumente "Tempo Máximo de Espera" para 15-20 minutos

Erro: "Model not found"

Solução: Sua conta pode não ter acesso ao Sora ainda


📞 Suporte


📜 Changelog

[1.0.0] - 2024-11-09

  • ✅ Geração de vídeo com Sora
  • ✅ Polling automático
  • ✅ Download de MP4
  • ✅ Múltiplas resoluções
  • ✅ Logs informativos

📄 Licença

MIT © Thiago D'Arezzo


🎩 Desenvolvido por Thiago D'Arezzo

🎬 Gere vídeos incríveis com IA! ✨

Discussion