liven — Imagen a Video (Nube)
Da vida a imágenes estáticas usando el modelo de difusión de video LTX-2.3 Fast que se ejecuta en la infraestructura en la nube de fal.ai. Proporciona una imagen y un prompt de movimiento; el modelo genera un breve videoclip (6-20 segundos según la configuración).
El directorio del skill (donde reside este SKILL.md) se denomina $SKILL_DIR a continuación.
Basado en la nube. No requiere GPU local. Requiere la variable de entorno
FAL_API_KEY. Precios: $0.04/s para 1080p, $0.08/s para 1440p, $0.16/s para 4K.
Cuándo Usarlo
Usa este skill cuando el usuario quiera:
- Animar una foto o ilustración en un video corto sin GPU local
- Crear movimiento cinematográfico a partir de una imagen fija (p. ej., zoom lento, paneo, parpadeo de luz)
- Generar contenido de video para redes sociales a partir de fotos de productos o retratos
- Usar resoluciones más altas (hasta 4K) sin limitaciones de VRAM local
Configuración (solo la primera vez)
cd "$SKILL_DIR" && uv sync
Configura la variable de entorno FAL_API_KEY:
export FAL_API_KEY="tu-clave-api-aqui"
Flujo de Trabajo del Agente
1. Pregunta al usuario
Antes de animar la(s) imagen(es), necesito saber:
💬 Prompt de movimiento (obligatorio)
Describe el movimiento que deseas, p. ej.:
"push-in cinematográfico lento, luz de hora dorada, deriva sutil de cámara"
🎬 Configuración del clip
- duration — duración del video en segundos (predeterminado: 6, opciones: 6, 8, 10, 12, 14, 16, 18, 20)
Nota: duraciones >10s solo admiten 25 FPS y 1080p
- resolution — calidad de salida (predeterminado: 1080p, opciones: 1080p, 1440p, 2160p/4K)
- aspect_ratio — relación de aspecto del video (predeterminado: auto, opciones: auto, 16:9, 9:16)
- fps — fotogramas por segundo (predeterminado: 25, opciones: 24, 25, 48, 50)
- generate_audio — generar audio IA para el video (predeterminado: true)
📁 Directorios de entrada/salida (predeterminado: ./input y ./output)
Espera la respuesta del usuario antes de continuar.
2. Edita config.json
Escribe o actualiza $SKILL_DIR/config.json según las elecciones del usuario.
3. Ejecuta
cd "$SKILL_DIR" && uv run python scripts/img2vid.py --config config.json
4. Informa los resultados
Informa al usuario:
- Rutas de los archivos de salida
- Duración y resolución del video
- Estimación de costo (basada en duración y resolución)
- URLs de descarga directa (los videos se alojan temporalmente en fal.media)
Referencia de Configuración
| Clave | Valores | Predeterminado | Descripción |
|---|---|---|---|
input_dir | ruta | ./input | Carpeta que contiene las imágenes de origen |
output_dir | ruta | ./output | Carpeta de destino |
prompt | cadena | (obligatorio) | Descripción del movimiento |
duration | entero | 6 | Duración del video en segundos (6-20) |
resolution | cadena | 1080p | Resolución de salida: 1080p, 1440p, 2160p |
aspect_ratio | cadena | auto | Relación de aspecto: auto, 16:9, 9:16 |
fps | entero | 25 | Fotogramas por segundo: 24, 25, 48, 50 |
generate_audio | booleano | true | Generar audio IA para el video |
end_image_url | cadena | null | Fotograma final opcional para videos de transición |
Invocaciones Comunes
# Animar con un prompt de movimiento (usa valores predeterminados: 6s, 1080p, 25fps)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "push-in cinematográfico lento, luz de hora dorada"
# Generar un video más largo de 10 segundos
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "viento suave en los árboles" --duration 10
# Crear un video vertical para redes sociales
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "movimiento sutil de cámara" --aspect-ratio 9:16
# Calidad 4K (mayor costo: $0.16/s)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "zoom out cinematográfico" --resolution 2160p --duration 8
# Mayor tasa de fotogramas para movimiento más suave
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "secuencia de acción rápida" --fps 48
# Deshabilitar generación de audio
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "escena de meditación silenciosa" --no-audio
# Crear transición entre dos imágenes
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "transición suave de morphing" \
--end-image /ruta/a/imagen_final.jpg
Salida
Cada imagen de entrada produce un clip .mp4 en output_dir, nombrado como <nombre_imagen>.mp4. El video también se sube temporalmente a la CDN de fal.media y se proporciona una URL de descarga en la salida de la consola.
Los metadatos del video (resolución, fps, duración) se imprimen después de la generación.
Manejo de Errores
- FAL_API_KEY faltante → error claro con instrucciones de configuración
- Formato de imagen no válido → error con formatos soportados (PNG, JPEG, WebP, AVIF, HEIF)
- Errores de API → mensaje de error de fal.ai propagado
- Problemas de red → lógica de reintento con mensajes de error claros
Referencia de Precios
| Resolución | Precio por segundo |
|---|---|
| 1080p | $0.04 |
| 1440p | $0.08 |
| 2160p (4K) | $0.16 |
Ejemplos:
- Video de 6s a 1080p = $0.24
- Video de 10s a 1080p = $0.40
- Video de 10s a 4K = $1.60