---
title: "Crear un Trabajo"
description: "Envía un trabajo de transcodificación: la URL u objeto S3 de origen, el bucket y las credenciales de destino, las salidas, y el webhook y la clave de idempotencia que conviene poner."
category: "Despliegue"
language: es
source: https://cubepath.com/es/docs/products/despliegue/transcoding-jobs-es
updated: 2026-10-28
---

# Crear un Trabajo

Abre **Video Transcoding** → **New Job** en [my.cubepath.com](https://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.

| Campo | Obligatorio | Notas |
|-------|-------------|-------|
| **Endpoint** | No | Déjalo vacío para AWS S3. Rellénalo para CubePath Object Storage, R2, B2, Wasabi o MinIO |
| **Región** | No | `auto` sirve para los proveedores que la ignoran |
| **Bucket** | **Sí** | El único campo que el formulario exige siempre |
| **Prefijo de destino** | No | P. ej. `transcoded/`. Todo lo que escriba el trabajo cuelga de ahí |
| **Access key** / **Secret key** | En la práctica sí | Solo puedes omitirlas si el bucket acepta escrituras anónimas, cosa que casi ninguno hace |

> 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](/docs/products/despliegue/transcoding-outputs-es).

## 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](/docs/products/despliegue/transcoding-job-status-es).
- **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

```steps
### Elige el origen
Selecciona **URL** o **S3** y rellena la URL, o el bucket y la clave del objeto.

### Rellena el destino
Endpoint, región, bucket, prefijo y las credenciales que puedan escribir ahí.

### Añade tus salidas
Una fila por versión. Empieza con un solo MP4 si estás probando el circuito completo.

![Salida de transcodificación con tipo, contenedor, códec y altura](https://cdn.cubepath.com/img/docs/products/52b960d0-ddf6-4853-b3cc-2a55f9ae77e6.png)

### Envía
El trabajo aparece en la lista como **queued** y arranca según se libera capacidad.
```

> 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

| Mensaje | Qué corregir |
|---------|--------------|
| Introduce una URL de descarga válida | El origen URL necesita una URL `http(s)://` completa |
| Introduce la clave del objeto | Un origen S3 necesita la clave del objeto además del bucket |
| El bucket de destino es obligatorio | Falta el bucket de destino |
| Añade al menos una salida | Todo trabajo necesita una o más salidas |
| "No se puede apuntar a una dirección privada/interna" | Una URL o un endpoint S3 apunta a una IP privada; usa un hostname público |
| Rechazado solo al escribir | La organización no está verificada, está suspendida o sin saldo |