Crear un Trabajo

Abre Video Transcoding → New Job en my.cubepath.com.

Un trabajo es un origen, un destino y una lista de salidas. No hay proyecto, perfil ni preset que configurar antes, y nada se arrastra de un trabajo a otro: cada envío trae su propio origen, su propio destino y sus propias credenciales. Es intencionado — un trabajo queda descrito por completo con lo que envías, así que puedes generarlos desde código sin ningún estado guardado que mantener sincronizado.

Origen

Elige primero el tipo de origen, porque cambia el resto del formulario.

• URL de descarga — una URL http:// o https:// que podamos descargar sin credenciales. El formulario rechaza lo que no sea una URL completa, y el servicio rechaza URLs que resuelvan a direcciones privadas o internas, así que un enlace a algo de tu propia LAN no va a funcionar.
• Bucket S3 — un objeto de un bucket tuyo. Indicas endpoint, región, bucket y clave del objeto, más una access key y una secret key. La clave del objeto es la ruta dentro del bucket (videos/charla-42.mov), no una URL.

Sea cual sea el origen, se lee una sola vez. Diez salidas no son diez descargas.

Destino

El destino siempre es un bucket compatible con S3, y es el único sitio donde escribe el trabajo. Rellénalo aunque sea el mismo bucket del que viene el origen: entrada y salida se configuran por separado.

Importante

Dale al trabajo una clave que pueda escribir en el prefijo de destino y leer el objeto de origen, y nada más. La secret key se guarda cifrada y la API nunca la devuelve, pero una clave acotada sigue siendo la diferencia entre filtrar la configuración de un trabajo y filtrar la cuenta entera.

Salidas

Añade al menos una salida — un trabajo sin ninguna se rechaza. Cada salida es una versión independiente del mismo origen y puedes mezclar tipos libremente: un MP4 para descarga, una escalera HLS para reproducción, miniaturas para la barra de progreso, un GIF para la tarjeta de vista previa. Los tipos y sus parámetros están en Salidas.

Avanzado

Dos campos opcionales, ambos recomendables:

• URL de webhook — te hacemos un POST cuando el trabajo llega a un estado final, para que tu tubería no tenga que sondear. La entrega es de mejor esfuerzo y no se reintenta; míralo en Estado del trabajo.
• Clave de idempotencia — una cadena única que eliges tú. Si se envía la misma clave otra vez, recibes el trabajo existente en lugar de uno nuevo. Ponla siempre que quien llama pueda reintentar: un worker de cola, un manejador de webhooks, un usuario que hace doble clic en Enviar.

Enviar

Consejo

Lanza un trabajo con un fichero pequeño y una sola salida MP4 antes de conectar nada. Eso valida las credenciales, el endpoint y el prefijo en un minuto, y a partir de ahí cualquier problema es un problema de verdad y no una errata en el nombre del bucket.

Cuando el formulario protesta