Automatización de vídeos con la API

Una API REST bajo /api/v1, autenticada con una clave API que creas en tu cuenta. Cubre las mismas funcionalidades que el resto del producto:

• Vídeos — crea un render a partir de una URL y un brief, consulta su estado, descarga el MP4 finalizado.
• Sitios — analiza un dominio, obtén un plan de qué páginas merecen un vídeo, genéralos.
• Personajes y capturas — los activos reutilizables que comparte una serie.
• Programas — episodios recurrentes impulsados por un feed.
• Conexiones — registra una fuente MCP o HTTP de la que un formato puede extraer datos.

Es una funcionalidad Pro, incluida a partir de 49 $ al mes. La clave está vinculada a tu cuenta y a tu saldo de créditos; no hay precios de API separados.

El renderizado es asíncrono, y cualquier integración debe construirse en torno a eso.

1. 1Crear. Envía la URL, el brief, la relación de aspecto y cualquier límite de presupuesto. Recibirás un ID inmediatamente; el renderizado no ha comenzado, y mucho menos ha terminado.
2. 2Consultar. Pregunta por el estado. Obtendrás la fase, el progreso y una estimación recalculada a partir del tiempo real que lleva ejecutándose este renderizado en particular, en lugar de un promedio.
3. 3Leer el resultado. Cuando esté listo, obtendrás el MP4, y las advertencias.
4. 4Verificar las advertencias. Un renderizado puede finalizar y aun así no estar completo, y el estado dirá done de cualquier manera. Un pipeline automatizado que ignora las advertencias es un pipeline que publica vídeos con fallos.

Calcula varios minutos por renderizado, más si genera clips. No mantengas una solicitud HTTP abierta esperando uno.

• Vídeo de catálogo. Un vídeo por página de producto, generado al publicar, incrustado en la página. La automatización de mayor valor, porque se ejecuta en páginas que ya reciben tráfico.
• Notas de lanzamiento en vídeo. Un vídeo por lanzamiento, generado a partir de la entrada del registro de cambios. create_animation no necesita ninguna página, por lo que el texto del registro de cambios es suficiente.
• Actualización de vídeos obsoletos. Vuelve a renderizar cuando la página cambie. Un vídeo de demostración que coincida con el producto actual vale más que uno mejor producido que muestre la interfaz del trimestre pasado.
• Variantes por idioma. La misma página, grabada con narración en cada idioma en el que vendes.

Prioriza antes de generar. El instinto con una API es ejecutarla en todo; el resultado es una gran factura de créditos y vídeos en páginas que nadie visita. Ordena por tráfico, toma la porción superior, mide y luego amplía.

1. 1Generar elementos visuales de IA por defecto. Un pipeline con clips habilitados en todo un catálogo es la forma más rápida de agotar un saldo: un clip de la casa cuesta 311 créditos frente a 40 de un renderizado, y un modelo concreto puede costar mucho más. Establece ai_budget en cada llamada y ponlo a cero por defecto para trabajos masivos.
2. 2Volver a renderizar páginas sin cambios según un horario. Activa por cambio, no por cron. Un trabajo nocturno sobre un catálogo estático paga el precio completo cada noche por una salida idéntica.
3. 3Ignorar las advertencias. Son lo único que se interpone entre un pipeline automatizado y la publicación de un vídeo cuya escena clave volvió silenciosamente a una tarjeta de texto.

Los renderizados se ejecutan uno a la vez por cuenta en lugar de todos a la vez, por lo que enviar doscientos trabajos los pone en cola en lugar de ejecutar doscientos navegadores. Diseña para una cola: envía, registra el ID, consulta con retroceso exponencial.

Un renderizado que falla por una razón del sistema se reembolsa automáticamente, por lo que un reintento después de un fallo genuino no se paga dos veces. Un renderizado que falla porque no se pudo acceder a la página —una verificación de robot, un muro de inicio de sesión, una URL muerta— se rechaza antes de que se cobre nada, y seguirá siendo rechazado hasta que la página cambie. Reintentarlo en un bucle no logra nada; verifica la razón y omítelo.

Para páginas detrás de un inicio de sesión, registra primero una sesión de captura desde la extensión de VS Code o del navegador. Está limitada a ese origen, caduca en tres días y es una funcionalidad del plan Scale.