Cortar un clip en el Editor y enviarlo a MediaCopilot
Available in: UI · API
Utiliza este flujo cuando una emisión capturada deba alimentar MediaCopilot para transcripción, subtitulado o generación automática de clips. La entrega se hace mediante el Editor de grabaciones en producto; enviar la exportación con MediaCopilot como destino ejecuta executeEditor con command = exportMediaCopilot.
Cuándo usar esto
Cuando una grabación finalizada debe cortarse en un clip (o enviarse entera) y entregarse a MediaCopilot para post-procesado con IA. Para la referencia de integración consulta MediaCopilot. Para el catálogo de grabaciones y el Editor consulta Recordings y Editor de grabaciones.
Prerrequisitos
- Una cuenta de MediaCopilot contratada a través de Cires21. C21 Live Control no aprovisiona MediaCopilot; la URL del tenant y el token API provienen de tu contrato de servicio con Cires21. Consulta MediaCopilot para el modelo de cuenta.
- La licencia C21LiveEditor en la instancia de Live Control. La pestaña Editor en Recordings queda oculta cuando falta esta licencia; sin el Editor no hay ruta desde la UI para cortar un clip y enviarlo a MediaCopilot. Consulta Licencias.
- La integración MediaCopilot configurada en
Integrations → MediaCopilot(un setup único realizado por un System Administrator). - Una grabación finalizada disponible — la exportación se ejecuta después de que el
ended_atde la grabación esté establecido, es decir, una vez que el Live stream productor se ha detenido.
Via UI
Navegación: Recordings → Editor.
Abre la grabación en el Editor
En la lista de grabaciones, pulsa la fila de la grabación que vas a exportar y ábrela en la pestaña Editor. El panel izquierdo muestra la línea temporal con las renditions capturadas.
Elige el clip
En el panel de exportación del Editor, establece:
| Etiqueta UI | Campo API | Notas |
|---|---|---|
| Quality | quality | Una de las renditions capturadas en la grabación. |
| Time intervals | intervals | Una o más marcas in / out en la línea temporal; cada una lleva un timestamp start y otro end (Unix). |
| Keyframe alignment | kfstart | Cuando se activa, el corte se ajusta al keyframe más cercano para no reencodear el primer segmento. |
| Concatenate intervals | concat | Cuando se activa, los intervalos del mismo bitrate se concatenan en una única salida. |
| Output encoding | encoding | Uno de ts, mp4, fmp4 o audio. |
Elige MediaCopilot como destino
En el selector Delivery del panel de exportación, elige MediaCopilot. El selector solo lista este destino cuando la integración MediaCopilot está configurada y el host tiene la licencia C21LiveEditor.
Envía
Pulsa Submit. El handler ejecuta el corte y envía el clip resultante a MediaCopilot. El panel lateral de jobs del Editor reporta el estado de la exportación; el Asset aparece en el tenant de MediaCopilot cuando la subida termina.
Via API
| Acción | Método + ruta | operationId |
|---|---|---|
| Ejecutar el Editor | POST /c21apiv2/editor/livestreams/{liveStreamId}/recordings/{recordingShortName}/execute | executeEditor |
Idempotency-Key se aplica en esta ruta.
curl -X POST "https://<tu-host>/c21apiv2/editor/livestreams/<livestreamId>/recordings/<recordingShortName>/execute" \
-H "Authorization: Bearer <YOUR_API_TOKEN>" \
-H "Idempotency-Key: <clave-única>" \
-H "Content-Type: application/json" \
-d '{
"quality": 0,
"allbitrates": false,
"intervals": [
{ "start": 1747585200, "end": 1747588800 }
],
"kfstart": true,
"concat": false,
"encoding": "mp4",
"command": "exportMediaCopilot"
}'
El cuerpo coincide exactamente con RecordingEditorRequest. Campos obligatorios: quality, allbitrates, intervals, kfstart, concat, encoding, command. exportMediaCopilot es un comando asíncrono cuando sync = false; consulta el endpoint del job para el estado.
El campo command acepta un enum cerrado:
command | Resultado |
|---|---|
download | Devuelve los bytes del corte inline como Content-Type: application/force-download. Síncrono. |
ftp | Entrega a un destino FTP remoto. Asíncrono. |
sftp | Entrega a un destino SFTP remoto. Asíncrono. |
s3 | Entrega a un bucket compatible con S3. Asíncrono. |
exportMediaCopilot | Entrega al tenant de MediaCopilot configurado. Asíncrono. |
Verificar
- El lado de MediaCopilot recibe el Asset y lo lista en su catálogo de Assets.
- La fila de la grabación en la lista mantiene los mismos campos canónicos (
name,duration_seconds,size_bytes,qualities,started_at,ended_at) — la exportación no modifica la grabación origen.
FAQ
intervals acepta uno o más rangos {start, end}. Con concat = true, los intervalos del mismo bitrate se concatenan en una única salida.ended_at: null en ese caso), pero el corte está limitado a los segmentos ya escritos en el momento de enviar la exportación. Para una entrega totalmente predecible, espera a que el Live stream se detenga y la grabación se cierre.Integrations → MediaCopilot. El token se almacena cifrado y nunca lo devuelve un GET.