Bonus 01: vídeo con FFmpeg y flujo opcional

Actualizado: 20 de febrero de 2026.

Este bonus documenta el flujo opcional para exportar un MP4 desde una imagen IA.

Prerrequisitos

1. Tener clonado o disponible codigo/ de esta serie.
2. Contar con Firebase y Novita configurados para pruebas.
3. Haber completado el capítulo anterior del curso.

Dónde está en el código

1. InvitationService.CreateVideoFromImageAsync(...)
2. NovitaTaskWorker.CreateVideoFromImageAsync(...)

Flujo

1. Recibir imagen final.
2. Guardar temporal (.jpg).
3. Ejecutar ffmpeg con escala según orientación.
4. Subir mp4 a Storage.

Ejemplo de comando FFmpeg

ffmpeg -loop 1 -t 5 -i input.jpg -c:v libx264 -vf scale=1024:1024 -pix_fmt yuv420p output.mp4

Recomendaciones

1. Mantén esto como flujo opcional (no core).
2. Valida binario ffmpeg en entorno de despliegue.
3. Aísla generación de vídeo en worker para evitar bloquear requests.

Troubleshooting

1. ffmpeg not found: instala FFmpeg en host/runner.
2. MP4 corrupto: valida argumentos y codec (libx264).
3. Escala incorrecta: revisa orientación (16:9, 9:16, 1:1).

FAQ corta

¿Novita ya devuelve vídeo?

Puede hacerlo según endpoint/formato; este bonus cubre fallback/control local.

¿Puedo añadir música?

Sí, en el método ya existe base para pista opcional.

Fuente

• Código del curso:
  • codigo/backend/InvitaIA.Api/Workers/NovitaTaskWorker.cs
  • codigo/backend/InvitaIA.Api/Services/InvitationService.cs