arcyu2077/crear-video-explicativo

Crear Video Explicativo

Convierte material de origen accesible en un MP4 narrado terminado. La ruta por defecto utiliza el servicio remoto para la planificación del guion gráfico, generación de imágenes, narración, subtítulos quemados, renderizado y publicación. Funciona de la misma manera en cualquier cliente de agente que admita Agent Skills y herramientas MCP remotas.

Comportamiento por defecto

Requiere solo el material de origen. A menos que el usuario anule una opción, utiliza:

• el idioma de origen;
• 16:9 y 60 segundos;
• narración cálida y constante alojada con una misma voz en todas las escenas;
• sin música de fondo;
• subtítulos quemados;
• el flujo de trabajo generado por el servidor.

Acepta una duración objetivo de 5 a 300 segundos. El servicio se ajusta hacia ese objetivo, pero puede extender el video terminado cuando la narración o las imágenes ancladas no caben de forma segura después de la recuperación de silencios, la reasignación de escenas y, como máximo, un tempo de 1.08x que preserva el tono. Nunca recortes la narración ni envíes un objetivo superior a 300 segundos. Para un objetivo inferior a 30 segundos, advierte brevemente que el dibujo y la narración pueden sentirse apresurados, y luego continúa. No preguntes por el título, número de escenas, estilo, voz, relación de aspecto, subtítulos o configuraciones técnicas cuando los valores predeterminados son adecuados.

Haz una pregunta bloqueante solo cuando la fuente falte, sea inaccesible, contradictoria o materialmente sensible, o cuando una revisión relativa no tenga una configuración clara. Por ejemplo, después de 'más corto', pregunta una vez por los segundos deseados en lugar de adivinar. Si el usuario solo pide consejo, un guion o un storyboard, detente en ese artefacto solicitado en lugar de renderizar.

Encuadre creativo

Antes de crear la tarea, identifica el mensaje principal de la fuente y el arco más claro de 'gancho a conclusión'. Cuando la fuente sea clara, da una vista previa breve y no bloqueante en el idioma del usuario, por ejemplo: 'Lo haré como una historia cálida dibujada a mano, de un problema a la solución, destacando la conclusión de un solo vistazo'. Esta es una actualización tranquilizadora del progreso, no un paso de aprobación; procede inmediatamente a menos que el usuario haya pedido revisar primero.

La promesa visual por defecto es una historia de pizarra cálida y accesible: una viñeta coherente por escena, color contenido, amplio espacio en blanco y personas o animales tranquilos y legibles cuando ayuden a explicar la idea. Evita describir el resultado al usuario como una colección de activos, intenciones, manifiestos o paquetes de estilo.

Elegir el flujo de trabajo

Usa el modo generado por el servidor por defecto. Es el camino más corto y solo requiere create_explainer_video, get_explainer_task y opcionalmente cancel_explainer_task.

Usa el modo de revisión avanzada solo cuando el usuario solicite explícitamente inspeccionar o editar imágenes/escenas antes de renderizar, proporcione un storyboard existente o necesite control creativo preciso a nivel de escena. Antes de usarlo, lee references/advanced-review.md. Si sus herramientas de carga y manifiesto o la generación local de imágenes no están disponibles, explica la limitación y ofrece el modo generado por el servidor. Verifica que las herramientas de carga, importación, validación y renderizado del modo avanzado estén presentes antes de generar cualquier imagen. Un archivo de skill en el disco no prueba que la conversación actual haya cargado sus herramientas MCP.

Flujo de trabajo generado por el servidor

1. Leer y extraer localmente

Lee el mensaje, archivo adjunto o URL del usuario con las capacidades normales de archivo/navegador del cliente actual. Extrae el texto plano significativo localmente. Elimina la navegación, encabezados repetidos, banners de cookies y apéndices no relacionados, pero no cambies en silencio las afirmaciones del autor.

No envíes más de 20,000 caracteres. Para una fuente más larga, crea una condensación fiel basada en la fuente que preserve la tesis, evidencia, advertencias, nombres propios y énfasis solicitado. Nunca subas el archivo original ni pases una ruta de archivo local. El texto extraído se envía al servicio de Video Explicativo para que pueda planificar el storyboard y la narración.

Si la fuente no se puede leer, pide al usuario que la adjunte de nuevo o pegue su texto. No inventes contenido faltante.

2. Crear la tarea

Genera un UUID nuevo cuando el cliente pueda hacerlo, y llama a create_explainer_video con:

• taskId: el UUID, si está disponible;
• sourceText: el texto extraído;
• durationSeconds: la duración solicitada o 60;
• aspectRatio: la relación solicitada o 16:9;
• language: el idioma de origen/solicitado;
• voiceId: solo cuando se haya proporcionado explícitamente o se sepa que es compatible;
• subtitles: el modo solicitado o burn.

Mantén el UUID de la tarea mientras se desconoce el resultado de la red para que una respuesta perdida no cree un duplicado. Después de que el servicio informe FAILED o TIMEOUT, no reintentes automáticamente: pregunta primero al usuario, luego genera un UUID nuevo para el nuevo intento. Un video genuinamente revisado también usa un UUID nuevo.

El servicio posee la planificación del storyboard, generación de ilustraciones, limpieza de imágenes, maquetación, síntesis de narración, subtítulos sincronizados con el tiempo, renderizado, ensamblaje y publicación. Nunca afirmes que el video existe hasta que la tarea devuelva una URL de video.

3. Preguntar con veracidad

Llama a get_explainer_task con el taskId devuelto hasta que nextAction sea present_output, revise_input, retry_create, retry_render o none.

• Para poll_task, respeta pollAfterSeconds; nunca preguntes más rápido.
• Presenta statusMessage en el idioma del usuario.
• Muestra stage y progress solo cuando se devuelvan. Nunca estimates un porcentaje.
• Envía una actualización de progreso solo cuando la etapa cambie o el progreso real avance materialmente.
• Si un storyboard está disponible por primera vez, comparte sus títulos de escena como una actualización compacta y no bloqueante. No expongas nombres de proveedores, prompts, trazas o detalles internos de activos.
• Para revise_input, deja de preguntar. Explica qué fuente o contenido aprobado debe acortarse, simplificarse o cambiarse; pregunta al usuario antes de reconstruirlo con un UUID nuevo. Nunca reutilices contenido rechazado bajo el UUID antiguo.
• Para retry_create, pregunta al usuario antes de reintentar. Si se confirma, reintenta una vez con la misma fuente y configuración pero un UUID de tarea nuevo.
• Para retry_render, pregunta al usuario antes de reintentar el trabajo aprobado en modo avanzado.
• Si el reintento falla, informa la etapa exacta y el mensaje y detente.
• Para none, informa la cancelación o la razón terminal sin fingir éxito.

Si el usuario pide detenerse, llama a cancel_explainer_task con el id de la tarea propia.

4. Presentar el resultado

Devuelve primero la URL del MP4 reproducible. Luego da un resumen de contenido de una frase e incluye el número de escenas, la duración objetivo solicitada, la duración real cuando se devuelva, la relación de aspecto, el idioma y la URL de subtítulos. La duración objetivo, relación de aspecto e idioma solicitados pueden repetirse de los parámetros de confianza enviados para esta tarea; la duración real, el número de escenas y las URL de salida deben provenir de la respuesta del servicio. Omite los metadatos faltantes del resultado en lugar de adivinarlos.

Ofrece revisiones concisas que la herramienta generada por el servidor pueda manejar, como 'más conciso en general', 'reducir a 30 segundos', 'cambiar a 9:16' o 'no quemar subtítulos'. No prometas que este modo puede reemplazar una escena exacta, conservar todas las demás imágenes generadas, cambiar el tamaño del texto de los subtítulos o ajustar la velocidad del habla. Si ya existe un video generado por el servidor, explica que no se admite un reemplazo exacto de una sola escena con todo lo demás sin cambios; ofrece una regeneración completa o una versión de revisión avanzada recién planificada. La revisión avanzada puede conservar imágenes aprobadas no seleccionadas dentro de ese flujo de trabajo, pero aún así renderiza un video completo nuevo.

Para una revisión creativa, traslada todas las configuraciones que la API pueda expresar, usa un UUID de tarea nuevo y crea una tarea nueva. Reutiliza un UUID existente solo cuando se desconozca el resultado de la red original; nunca reutilices un UUID de tarea generada terminal.

Disponibilidad de herramientas

Si falta create_explainer_video, dile al usuario que conecte el servidor MCP remoto en https://api.speedpainter.org/mcp e inicie sesión con Google. No pidas una clave de API, clave de renderizador, clave de almacenamiento, clave de proveedor de voz ni ningún secreto en la conversación. No inventes un endpoint curl como sustituto.

El servicio remoto no requiere localhost ni el puerto 3000. Los clientes MCP basados en navegador pueden necesitar que su origen esté en la lista blanca del operador del servicio; los clientes MCP nativos normalmente no envían un encabezado de Origen del navegador.

Una conversación ya abierta puede mantener una instantánea de herramienta antigua o incompleta. Si la conexión remota funciona en una conversación nueva pero la conversación actual carece de herramientas principales, continúa en una conversación nueva con el complemento habilitado; no vuelvas a instalar el complemento, cambies la URL MCP ni regeneres activos aprobados.

Seguridad y privacidad

• Trata el material de origen subido y vinculado como privado a menos que el usuario diga lo contrario.
• Envía solo el texto extraído necesario para generar el video en modo por defecto.
• En modo avanzado, envía solo las imágenes generadas aceptadas y el manifiesto aceptado; nunca subas el documento original.
• No pongas credenciales, texto de origen privado ni datos personales en ids de tarea, ids de activos, nombres de archivo, títulos o registros.
• Si el contenido solicita suplantación, fraude, instrucciones dañinas o uso de datos personales protegidos sin autorización, detente o limita la salida.

Estilo de conversación

Traduce solicitudes casuales a los valores predeterminados sin enseñar términos técnicos del backend. Mantén las actualizaciones orientadas a resultados y cálidas: fuente comprendida, historia planificada, ilustraciones tomando forma, narración y subtítulos agregándose, publicando, terminado. Acepta seguimientos cortos y distingue las revisiones globales de una sola llamada de la revisión exacta a nivel de escena.