ViralVibe AI — API

Concepto

Micro-SaaS que convierte un texto/prompt, o la URL de un artículo/página de producto, en un video corto (15-60s) listo para TikTok/Reels/Shorts: clips de stock, voz en off IA, música, subtítulos dinámicos estilo Hormozi y marca de agua de marca propia. Freemium: plan FREE con marca de agua de ViralVibe AI y límite mensual; STARTER/PRO sin marca de agua, más volumen y plantillas premium.

Arquitectura

• Spring Boot 4.0.4 / Java 25, capas %%INLINE0%% → %%INLINE1%% → %%INLINE2%% → %%INLINE3%%.
• Persistencia: JPA + H2 embebido en dev (auto-configurado, sin credenciales) / PostgreSQL en prod.
• Seguridad: Spring Security stateless + JWT (%%INLINE4%% 0.12.6). %%INLINE5%%

valida el header %%INLINE6%% en cada request y puebla el %%INLINE7%%.

• Generación asíncrona: %%INLINE8%% persiste el proyecto en %%INLINE9%%

y dispara %%INLINE10%% marcado %%INLINE11%%, ejecutado sobre un SimpleAsyncTaskExecutor con virtual threads (Java 25) — evita bloquear hilos de plataforma mientras se espera a las APIs externas de IA (guion, TTS, composición).

• Integraciones externas: 3 clientes Feign (feign/) — guion, texto-a-voz y compositor de

video. Sin credenciales reales configuradas, cada paso captura el fallo de red y degrada a una simulación local determinista, dejando el flujo end-to-end operable para la demo/dev.

• Adaptación de URL: %%INLINE14%% hace %%INLINE15%% GET a la URL, extrae

<title> y texto plano como puntos clave; ante timeout/DNS/4xx degrada a resumen simulado.

• Errores: %%INLINE17%% (%%INLINE18%%) homogeniza respuestas de error

(404/400/409/401/500) vía ErrorResponse.

• Jackson 3: %%INLINE20%% (pre-existente) expone %%INLINE21%% (tools.jackson.*).

Endpoints

Método	Ruta	Auth	Descripción
POST	/api/auth/register	público	Registro de usuario, devuelve JWT
POST	/api/auth/login	público	Login, devuelve JWT
GET	/api/templates	público	Plantillas de tendencia (formato, gancho, audio, subtítulos)
POST	/api/projects	JWT	Crea proyecto y dispara generación async (202 Accepted)
GET	%%INLINE27%%	JWT	Estado y %%INLINE28%% del proyecto
GET	/api/projects	JWT	Lista proyectos del usuario autenticado
PUT	/api/users/me/brand-kit	JWT	Fija logo del kit de marca (marca de agua auto)
GET	/api/users/me/brand-kit	JWT	Consulta kit de marca actual

Ejemplo de flujo

POST /api/auth/register {"email":"ana@pyme.com","password":"secret123"} -> 201 {token,...}
POST /api/projects  Authorization: Bearer <token>
  {"prompt":"3 tips para vender más en TikTok","templateId":"hormozi-hook-poc"}
  -> 202 {id, status:"PENDING", ...}
GET /api/projects/{id} -> status:"COMPLETED", videoUrl:"https://cdn.viralvibe.ai/..."

Referencias

• Product Hunt Leaderboard (dic. 2024) — validación de tendencia Zebracat 2.0 / video IA.
• jjwt 0.12.6 (JWT), Spring Cloud OpenFeign 4.2.1, MapStruct 1.6.3 (dependencias listadas en pom.xml).

Análisis de negocio

• Mercado: equipos de marketing en pymes, social media managers, agencias, creadores

individuales — todos con presión de publicar video corto consistentemente sin equipo de edición.

• Cuña de valor: no es "otra herramienta de edición" — automatiza guion + voz + subtítulos

virales + marca de agua en un solo POST, con plantillas basadas en tendencias reales.

• Monetización: freemium (Plan.FREE = 5 videos/mes con marca de agua ViralVibe, aplicado en

VideoProjectService); STARTER/PRO levantan el límite y quitan la marca de agua (%%INLINE35%%). Plantillas %%INLINE36%% reservadas a planes pagos (a completar con un gate de plan en TrendTemplateService cuando haya billing real).

• Foso competitivo: el "kit de marca" + subtítulos estilo Hormozi + selección de plantillas

trending son diferenciadores de producto frente a herramientas genéricas de IA de video.

Cómo ejecutar

cd solutions/2026-07-11-viralvibe-ai-api
mvn spring-boot:run

• Perfil por defecto: H2 en memoria (auto-configurado, sin variables requeridas).
• Para producción, definir %%INLINE38%% (PostgreSQL), %%INLINE39%%

(mínimo 256 bits) y app.ai.*-api-url para las APIs reales de IA vía variables de entorno.

• Consola H2 disponible en /h2-console (dev).

---

FinOps Analysis

Estimación de Costos Operativos Mensuales

Para ViralVibe AI, una micro-startup enfocada en la generación de video viral con IA, hemos desglosado los costos operativos mensuales iniciales y la estimación de ingresos para calcular el margen de beneficio.

1. Estimación de Tokens LLM

Se estima un consumo de ~15 millones de tokens/mes. Esta cifra considera la generación de scripts, resúmenes de URLs, análisis de tendencias y refinamiento de prompts para APIs de generación de video. Se asume una combinación estratégica de modelos como %%INLINE42%% para tareas de gran volumen y %%INLINE43%% para aquellas que requieren mayor calidad o creatividad, lo que resulta en un costo promedio de $15/mes.

2. Desglose de Costos Mensuales

• LLM Tokens: $15
• Cloud Hosting (EC2, S3): $25
• Base de Datos (RDS PostgreSQL): $15
• Monitoring (CloudWatch/Logs): $5
• APIs Externas (Generación de Video, TTS, Stock Media): $175
• Costo Total Estimado Mensual: $235

3. Costos de Infraestructura Cloud

La infraestructura base para una aplicación Spring Boot con Java 25 y PostgreSQL en la nube (ej. AWS) se estima en:

• Instancia EC2 (t3.small): ~$20/mes (para el microservicio Spring Boot)
• RDS PostgreSQL (db.t3.micro): ~$20/mes (para la base de datos relacional)
• Almacenamiento S3: ~$5/mes (para videos generados y assets, estimado para ~700 videos de 20MB cada uno, más transferencias)
• Costo Total de Infraestructura: $45/mes

4. Costos de APIs Externas

Los costos de APIs externas son el componente más significativo:

• OpenAI (LLM tokens): $15/mes (para el procesamiento de texto, como se detalló anteriormente)
• APIs de Generación de Video: Se asume un costo promedio de $0.25 por video generado (incluyendo voz en off, stock media y composición). Con una proyección de 700 videos/mes (basado en la base de usuarios estimada), esto suma $175/mes.
• Costo Total de APIs Externas: $190/mes

Estimación de Ingresos Mensuales

Basado en un modelo freemium con planes Starter ($25/mes por 15 videos) y Pro ($75/mes por 50 videos), se proyecta una base de usuarios inicial para una micro-startup: 20 clientes Starter: 20 $25 = $500/mes 5 clientes Pro: 5 $75 = $375/mes

• Ingreso Total Estimado Mensual: $875/mes

Margen de Beneficio

• Ingresos: $875
• Costos: $235
• Beneficio Neto: $875 - $235 = $640

Margen de Beneficio: (($640 / $875) 100) = 73%

Optimizaciones FinOps Clave

Para mantener y mejorar este margen, ViralVibe AI debe centrarse en las siguientes estrategias:

1. Optimización del Consumo de LLM: Implementar un caché robusto para prompts y respuestas comunes, especialmente para el análisis de tendencias y la generación de scripts repetitivos. Priorizar el uso de modelos LLM más económicos (como %%INLINE44%%) para tareas que no requieren la máxima complejidad, reservando modelos más caros (%%INLINE45%%) para casos específicos de alto valor.
2. Gestión Inteligente de APIs de Generación de Video: Explorar y negociar con múltiples proveedores de APIs de generación de video para obtener las tarifas más competitivas. Implementar la reutilización inteligente de clips de stock, voces en off generadas y plantillas para reducir los costos por video. Considerar la posibilidad de construir componentes de composición de video internos para tareas repetitivas si el volumen lo justifica.
3. Eficiencia de Infraestructura Cloud: Monitorear activamente el uso de EC2 y RDS. Utilizar instancias reservadas (Reserved Instances) para los recursos base una vez que la carga de trabajo sea predecible, lo que puede generar ahorros significativos a largo plazo. Implementar auto-escalado para ajustar los recursos a la demanda y evitar el sobreaprovisionamiento en horas de baja actividad.
4. Gestión del Almacenamiento S3: Configurar políticas de ciclo de vida para los objetos en S3, moviendo automáticamente los videos generados más antiguos a clases de almacenamiento de menor costo (como S3 Infrequent Access o S3 Glacier) después de un período determinado (ej. 30 o 60 días), ya que es probable que la demanda de acceso disminuya con el tiempo.
5. Procesamiento Asíncrono y en Lotes: Aprovechar los Virtual Threads de Java 25 y el procesamiento @Async para manejar las tareas de generación de video. Evaluar la posibilidad de realizar el procesamiento de tareas de baja prioridad en lotes durante las horas de menor actividad, lo que podría reducir los costos de computación y API si se pueden negociar tarifas por volumen o por franja horaria.

Conclusión

ViralVibe AI muestra un margen de beneficio saludable en esta etapa inicial. La clave para la sostenibilidad y el crecimiento será la gestión proactiva de los costos de las APIs de IA, que representan la mayor parte de los gastos operativos. La implementación temprana de prácticas FinOps permitirá a la startup escalar de manera eficiente y maximizar su rentabilidad.