Videito — Videos rápidos desde templates HTML

Genera videos verticales (stories) aplicando overlays HTML/CSS sobre secuencias de imágenes y videos. Ideal para anuncios, fichas de producto y contenido social.

Qué hace
  • Concatena videos e imágenes
  • Renderiza overlays con tus templates Handlebars
  • Produce MP4 H.264 1080x1920, listo para redes
Probar API
Beneficios
  • Automatiza creativos a partir de datos
  • Plantillas reutilizables
  • Funciona con URLs remotas (videos/imagenes)

Cómo usar (rápido)

Asegúrate de tener el servidor arrancado (npm start o node server.js), luego llama al endpoint POST /render con la lista de clips y el template.

Ejemplo curl 
curl -X POST http://localhost:3000/render \
  -H "Content-Type: application/json" \
  -d '{"clips":[{"type":"image","url":"https://example.com/photo.jpg","duration":4}],"template":"KumoA2Story","data":{"marca":"FORD","modelo":"ECOSPORT"}}'

Respuesta: recibirás el uuid y URLs para ver/descargar el video.

Templates ejemplos

Coloca tus plantillas en la carpeta templates/. Ejemplos incluidos:

Jobs y estado

Las llamadas que generan videos (`/render`, `/concatenate`, `/html2video`) arrancan un proceso en background y devuelven inmediatamente un objeto con el `uuid` y `status: "running"`.

Respuesta inicial (ejemplo) 
{
  "uuid": "3320820a-942f-4058-a54c-d11a2629e9cc",
  "status": "running",
  "startedAt": "2026-03-11T10:00:00.000Z"
}

Para consultar el estado final, usa GET /s/:uuid. Respuestas:

En ejecución 
{ "uuid": "...", "status": "running", "startedAt": "..." }
Finalizado 
{
  "uuid": "...",
  "status": "done",
  "duration": 30,
  "width": 1080,
  "height": 1920,
  "size": 1433879,
  "startedAt": "2026-03-11T10:00:00.000Z",
  "endedAt": "2026-03-11T10:00:30.000Z",
  "url": "/v/...",
  "downloadUrl": "/v/...?download=1"
}
Error 
{ "uuid": "...", "status": "error", "error": "Descripcion del error", "startedAt": "...", "endedAt": "..." }

Ejemplo de consulta (reemplaza UUID):

curl http://localhost:3000/s/3320820a-942f-4058-a54c-d11a2629e9cc