API de concatenación de vídeo para desarrolladores: unir MP4, MOV y AVI con REST

API de concatenación de vídeo para desarrolladores: unir MP4, MOV y AVI con REST

Las canalizaciones de vídeo reciben recursos de más de una fuente. Una aplicación móvil puede enviar MP4, una integración de cámara entregar MOV y un archivo conservar AVI o MPEG. Cuando el siguiente sistema espera un medio predecible, cada equipo acaba inspeccionando, normalizando, concatenando y exponiendo el resultado por su cuenta. VideoConcat ofrece esa capacidad como una API REST asíncrona de concatenación de vídeo.

El endpoint y el modelo de solicitud

Los clientes autenticados envían una solicitud multipart a POST /api/files/start-process. Indique actionName=VideoConcat, incluya de 2 a 15 vídeos como file0 hasta file14 y envíe parameters=[] y async=true como en los ejemplos públicos. También puede enviar URL públicas en fileUrl, separadas por |; se pueden combinar cargas y URL. Consulte los ejemplos y el contrato en la documentación de la API VideoConcat.

La respuesta inicial es un registro de proceso, no el archivo final. Guarde id y trackingUrl y consulte /api/actions/get-action-infos/{id} con el mismo JWT Bearer hasta que termine. Así no mantiene una conexión HTTP abierta durante la normalización y la codificación.

Por qué importa el procesamiento asíncrono

Un conjunto pequeño de clips compatibles puede terminar rápidamente, mientras que fuentes grandes, largas o de alta resolución requieren más trabajo. Una API asíncrona para unir vídeos permite confirmar la solicitud, guardar el identificador y actualizar el estado propio desde el endpoint de seguimiento. Un worker puede completar el trabajo independientemente de la petición web.

Trate el identificador como referencia de estado, nunca como autorización. Mantenga el contexto del usuario autenticado en las peticiones de estado y descarga y use los enlaces de resultado que entrega el servidor. Conocer un número entero no debe conceder acceso a un resultado.

Una salida predecible

Antes de unirlos, VideoConcat normaliza cada origen. Acepta 3GP, AVI, FLV, M4V, MKV, MOV, MP4, MPEG, MPG, OGV, TS, WebM y WMV, incluso mezclados en la misma solicitud. La salida busca una resolución común de hasta 1920×1080, 30 imágenes por segundo, vídeo H.264 y audio AAC. El letterboxing conserva el encuadre si cambian las proporciones y se añade una pista silenciosa cuando falta audio.

El resultado correcto expone un MP4 descargable, útil para una cola de transcodificación, un gestor de recursos, un flujo de publicación o un portal de clientes. Su aplicación todavía debe comprobar el significado de los clips y decidir si hacen falta subtítulos, marca o edición: la API resuelve la concatenación, no la aprobación editorial.

Validación y propiedad

La validación del servidor comprueba el número de entradas, el contenido de vídeo real, el MIME, la propiedad y los límites. Cada vídeo está limitado a 100 MB y 10 minutos; la solicitud completa a 1 GB y 30 minutos, con entre 2 y 15 vídeos. Las reglas no dependen de la extensión, JavaScript ni del tipo declarado por el navegador.

Un nombre como clip.mp4 no demuestra que los bytes sean un MP4 válido, y el selector de archivos no es una frontera de autorización. Envíe archivos de la cuenta autenticada, proteja el JWT y trate los errores de validación como fallos de entrada, sin reintentarlos indefinidamente. Las URL públicas deben ser fuentes que su aplicación pueda procesar.

Precio y reintentos

Una ejecución exitosa cuesta 15 tokens y una validación rechazada no se factura. Distinga en su sistema entre solicitud rechazada, proceso en curso, procesamiento fallido y éxito. No cree un segundo proceso solo porque una consulta de estado agotó su tiempo: recupere primero el estado existente.

Guarde la ID, use un polling acotado con backoff y, al finalizar, conserve la referencia recibida y descargue mediante el flujo autenticado. Si su webhook o cola recibe una notificación duplicada, haga idempotente también ese consumidor.

Dónde integrar la API

Los casos habituales son reunir clips enviados por clientes, preparar una copia de revisión desde varias cámaras, entregar un archivo único a un CMS o archivar segmentos de formación. Puede aceptar MP4 y MOV desde rutas distintas sin obligar a sus usuarios a aprender FFmpeg o un editor de escritorio.

Para ejemplos multipart, respuestas de estado y descargas, consulte la documentación REST de VideoConcat. Cuando necesite unir MP4, MOV, AVI u otros formatos compatibles en un MP4 normalizado, obtendrá un contrato pequeño y trazable para procesamiento asíncrono.