videoagent-video-studio

🎬 VideoAgent Video Studio

Use quando: O usuário pedir para gerar um vídeo, criar um vídeo a partir de texto, animar uma imagem, fazer um clipe curto ou produzir vídeo com IA.

Gere vídeos curtos com IA usando 7 backends. Esta habilidade escolhe o modo correto (texto para vídeo ou imagem para vídeo), melhora o prompt para melhores resultados e retorna a URL do vídeo.

---

Referência Rápida

Intenção do Usuário	Modo	Duração Típica
"Faça um vídeo de..." (sem imagem)	text-to-video	4–10 s
"Anime esta imagem" / "Faça isso se mover"	image-to-video	4–6 s
"Transforme isso em um vídeo com..."	image-to-video	4–6 s
Cinemático, história, anúncio	Prefira text-to-video com prompt detalhado	5–10 s

Modos de Geração

Modo	Descrição	Modelos
text-to-video	Apenas prompt de texto → vídeo	minimax, kling, veo, hunyuan, grok, seedance
image-to-video	Imagem única + prompt → clipe animado	minimax, kling, veo, pixverse, grok, seedance
com referência	Imagens/vídeo de referência → saída consistente	minimax, kling, veo, hunyuan, grok, seedance

Modelos (use --model <id>)

ID do Modelo	T2V	I2V	Referência	Notas
minimax	✅	✅	✅	Imagem de referência do sujeito, consistência de personagem
kling	✅	✅	✅	Multi-elemento / personagem / keyframe (O3)
veo	✅	✅	✅	Google Veo 3.1, múltiplas imagens de referência
hunyuan	✅	—	✅	Transferência de estilo vídeo para vídeo
pixverse	—	✅	—	Imagem para vídeo estilizada
grok	✅	✅	✅	Edição de vídeo via vídeo de referência
seedance	✅	✅	✅	Seedance 1.5 Pro, áudio sincronizado, 4–12 s

Detalhes completos dos modelos e referência de endpoint: references/models.md.

---

Como Gerar um Vídeo

Passo 1 — Escolha o modo e melhore o prompt

• Texto para vídeo: Expanda com sujeito, ação, movimento de câmera, iluminação e estilo. Seja específico sobre o movimento (ex.: "câmera faz zoom lentamente", "personagem anda da esquerda para a direita").
• Imagem para vídeo: Descreva o movimento a ser aplicado à imagem (ex.: "brisa suave no cabelo", "câmera panorâmica pela cena"). Consulte references/prompt_guide.md para padrões.

Passo 2 — Execute o script

Texto para vídeo:

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "<prompt aprimorado>" \
  --duration <segundos> \
  --aspect-ratio <proporção>

Imagem para vídeo:

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "<descrição do movimento>" \
  --image-url "<URL pública da imagem>" \
  --duration <segundos> \
  --aspect-ratio <proporção>

Parâmetros:

Parâmetro	Padrão	Descrição
--mode	text-to-video	text-to-video ou image-to-video
--prompt	(obrigatório)	Descrição da cena ou movimento
--image-url	—	Obrigatório para image-to-video; URL pública da imagem
--duration	5	Duração em segundos (geralmente 4–10)
--aspect-ratio	16:9	16:9, 9:16, 1:1, 4:3, 3:4
--model	auto	ID do modelo (ex.: kling, veo, grok, seedance); auto = proxy escolhe

Outros comandos:

Comando	Descrição
node tools/generate.js --list-models	Lista modelos disponíveis do proxy
node tools/generate.js --status --job-id <id>	Verifica status de trabalho assíncrono

Passo 3 — Retorne o resultado

O script retorna JSON:

{
  "success": true,
  "mode": "text-to-video",
  "videoUrl": "https://...",
  "duration": 5,
  "aspectRatio": "16:9"
}

Envie videoUrl para o usuário.

---

Exemplos de Conversas

Usuário: "Gere um vídeo curto de um gato andando na chuva, cinemático."

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "Um gato andando na chuva, ruas molhadas, reflexos de neon, iluminação cinematográfica, câmera lenta, 4K" \
  --duration 5 \
  --aspect-ratio 16:9

---

Usuário: "Anime esta foto" (usuário envia uma paisagem)

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "Nuvens suaves se movendo pelo céu, movimento sutil da grama, atmosfera cinematográfica" \
  --image-url "https://..." \
  --duration 5 \
  --aspect-ratio 16:9

---

Usuário: "Faça um vídeo vertical de 10 segundos de um café sendo servido, câmera lenta."

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "Close-up de café sendo servido em uma xícara branca, câmera lenta, vapor subindo, iluminação suave, fotografia de produto" \
  --duration 10 \
  --aspect-ratio 9:16

---

Usuário: "Use Google Veo para um plano cinemático."

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --model veo \
  --prompt "Um dragão voando por céus nublados, iluminação cinematográfica, 8s" \
  --duration 8 \
  --aspect-ratio 16:9

---

Usuário: "Anime este retrato."

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --model grok \
  --prompt "Sorriso suave, virada de cabeça sutil" \
  --image-url "https://..." \
  --duration 5

---

Configuração

Nenhuma chave de API por padrão. As requisições passam por um proxy hospedado. Defina estas para um proxy personalizado ou token:

Variável	Obrigatório	Descrição
VIDEO_STUDIO_PROXY_URL	Não	URL base do proxy
VIDEO_STUDIO_TOKEN	Não	Token de autenticação se o proxy exigir

---

Base de Conhecimento

• references/prompt_guide.md — Padrões de prompt para texto para vídeo e imagem para vídeo.
• references/models.md — Lista de modelos, capacidades e guia de seleção.
• references/calling_guide.md — Detalhes de endpoint por modelo, parâmetros de entrada e tratamento especial.