Guía de JSON a video

Cuándo usarlo

Usa un flujo de trabajo JSON a video cuando:

• la salida de video se derive de datos estructurados
• necesites varias variantes a partir de la misma lógica de plantilla
• un producto, agente o sistema de automatización deba activar la creación de video
• quieras vistas previas antes de la salida final
• necesites tareas de renderizado asíncronas y callbacks de entrega

Si el flujo consiste sobre todo en que una persona edite un solo video cada vez, un editor manual puede ser más simple. Si el flujo necesita repetibilidad e integración de software, JSON suele ser la mejor superficie de control.

Flujo de trabajo recomendado

1. Generar o ensamblar el esquema de video
2. Validar la estructura del esquema y las referencias de assets
3. Crear una vista previa
4. Revisar o refinar el esquema
5. Iniciar la tarea de renderizado final
6. Consultar el estado de la tarea o recibir un webhook
7. Almacenar o entregar el asset final

Lista de implementación

• Define la forma del esquema de video que generará tu producto
• Decide cómo se subirán o referenciarán los assets
• Valida los campos obligatorios antes de renderizar
• Genera vistas previas para revisión por parte del usuario o del sistema
• Guarda los IDs de tarea y las transiciones de estado
• Gestiona renderizados fallidos y reintentos
• Entrega los assets finales mediante polling o webhooks
• Mantén las plantillas reutilizables separadas de los datos de ejecución

Superficie mínima del esquema

Un esquema de producción normalmente necesita:

• meta para ajustes del canvas y metadatos del video
• assets para imágenes, videos, audio y fuentes
• tracks para la estructura de la línea de tiempo
• clips para texto, medios, formas, subtítulos y layouts
• reglas de tiempo y animación
• información de salida y ciclo de vida de la tarea

Para las reglas exactas a nivel de campo, consulta la referencia Estructura JSON y reglas de campos.

Vista previa, renderizado y entrega

• Vista previa: generar un borrador rápido para revisar el layout y los textos
• Renderizado: crear el asset final de salida
• Entrega: exponer el resultado mediante polling, búsqueda de tareas o un webhook

Para los detalles específicos de la API, continúa con API y uso.

Documentos relacionados

• Detalles del esquema: Estructura JSON y reglas de campos
• Flujo de ejecución: API y uso
• Payloads listos para copiar: Ejemplos
• Guías prácticas desde cero: Tutoriales