VideoAgent Video Studio

🎬 VideoAgent Video Studio

Úsalo cuando: El usuario pida generar un video, crear un video a partir de texto, animar una imagen, hacer un clip corto o producir video con IA.

Genera videos cortos con IA usando 7 motores. Esta habilidad elige el modo adecuado (texto a video o imagen a video), mejora la indicación para obtener los mejores resultados y devuelve la URL del video.

---

Referencia rápida

Intención del usuario	Modo	Duración típica
"Haz un video de..." (sin imagen)	text-to-video	4–10 s
"Anima esta imagen" / "Haz que esto se mueva"	image-to-video	4–6 s
"Convierte esto en un video con..."	image-to-video	4–6 s
Cinematográfico, historia, anuncio	Preferir text-to-video con indicación detallada	5–10 s

Modos de generación

Modo	Descripción	Modelos
text-to-video	Solo indicación de texto → video	minimax, kling, veo, hunyuan, grok, seedance
image-to-video	Una sola imagen + indicación → clip animado	minimax, kling, veo, pixverse, grok, seedance
basado en referencia	Imágenes/video de referencia → resultado coherente	minimax, kling, veo, hunyuan, grok, seedance

Modelos (usa --model <id>)

ID del modelo	T2V	I2V	Referencia	Notas
minimax	✅	✅	✅	Imagen de referencia del sujeto, coherencia de personaje
kling	✅	✅	✅	Múltiples elementos / personaje / fotograma clave (O3)
veo	✅	✅	✅	Google Veo 3.1, múltiples imágenes de referencia
hunyuan	✅	—	✅	Transferencia de estilo video a video
pixverse	—	✅	—	Imagen a video estilizada
grok	✅	✅	✅	Edición de video mediante video de referencia
seedance	✅	✅	✅	Seedance 1.5 Pro, audio sincronizado, 4–12 s

Detalles completos del modelo y referencia de endpoints: references/models.md.

---

Cómo generar un video

Paso 1: Elige el modo y mejora la indicación

• Texto a video: Amplía con el sujeto, la acción, el movimiento de cámara, la iluminación y el estilo. Sé específico sobre el movimiento (ej. "la cámara se acerca lentamente", "el personaje camina de izquierda a derecha").
• Imagen a video: Describe el movimiento que se aplicará a la imagen (ej. "brisa suave en el cabello", "la cámara se desplaza por la escena"). Consulta references/prompt_guide.md para ver patrones.

Paso 2: Ejecuta el script

Texto a video:

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "<indicación mejorada>" \
  --duration <segundos> \
  --aspect-ratio <relación>

Imagen a video:

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "<descripción del movimiento>" \
  --image-url "<URL pública de la imagen>" \
  --duration <segundos> \
  --aspect-ratio <relación>

Parámetros:

Parámetro	Valor por defecto	Descripción
--mode	text-to-video	text-to-video o image-to-video
--prompt	(obligatorio)	Descripción de la escena o del movimiento
--image-url	—	Obligatorio para image-to-video; URL pública de la imagen
--duration	5	Duración en segundos (normalmente 4–10)
--aspect-ratio	16:9	16:9, 9:16, 1:1, 4:3, 3:4
--model	auto	ID del modelo (ej. kling, veo, grok, seedance); auto = el proxy elige

Otros comandos:

Comando	Descripción
node tools/generate.js --list-models	Lista los modelos disponibles desde el proxy
node tools/generate.js --status --job-id <id>	Verifica el estado de un trabajo asíncrono

Paso 3: Devuelve el resultado

El script devuelve JSON:

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

Envía videoUrl al usuario.

---

Ejemplos de conversaciones

Usuario: "Genera un video corto de un gato caminando bajo la lluvia, cinematográfico."

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "Un gato caminando bajo la lluvia, calles mojadas, reflejos de neón, iluminación cinematográfica, cámara lenta, 4K" \
  --duration 5 \
  --aspect-ratio 16:9

---

Usuario: "Anima esta foto" (el usuario sube un paisaje)

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "Nubes suaves moviéndose por el cielo, movimiento sutil del pasto, atmósfera cinematográfica" \
  --image-url "https://..." \
  --duration 5 \
  --aspect-ratio 16:9

---

Usuario: "Haz un video vertical de 10 segundos de un vertido de café, cámara lenta."

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "Primer plano de café vertiéndose en una taza blanca, cámara lenta, vapor ascendente, iluminación suave, toma de producto" \
  --duration 10 \
  --aspect-ratio 9:16

---

Usuario: "Usa Google Veo para una toma cinematográfica."

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --model veo \
  --prompt "Un dragón volando entre cielos nublados, iluminación cinematográfica, 8s" \
  --duration 8 \
  --aspect-ratio 16:9

---

Usuario: "Anima este retrato."

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --model grok \
  --prompt "Sonrisa suave, ligero giro de cabeza" \
  --image-url "https://..." \
  --duration 5

---

Configuración

Sin claves API por defecto. Las solicitudes pasan por un proxy alojado. Configura estas variables para un proxy o token personalizados:

Variable	Obligatorio	Descripción
VIDEO_STUDIO_PROXY_URL	No	URL base del proxy
VIDEO_STUDIO_TOKEN	No	Token de autenticación si el proxy lo requiere

---

Base de conocimiento

• references/prompt_guide.md — Patrones de indicaciones para texto a video e imagen a video.
• references/models.md — Lista de modelos, capacidades y guía de selección.
• references/calling_guide.md — Detalles de endpoints por modelo, parámetros de entrada y manejo especial.