CubePathDOCS

Transcoder

Create transcoding job

post/transcoder/jobs

Submit a video for transcoding. Pick the output quality ladder you need and we deliver the finished files to your storage.

Autorización

Authorization
Authorization*string

Bearer YOUR_API_TOKEN con un token de API. También vale la cabecera X-API-Key: YOUR_API_TOKEN.

Cuerpo de la petición

application/jsonObligatorio
input*JobInput
Propiedades (3)
source*string
Valores"url""s3"
url?string | null
Rangolength ≤ 2048
s3?S3Config | null
Propiedades (6)
endpoint?string | null

S3-compatible endpoint URL (omit for AWS S3)

Rangolength ≤ 512
region?string | null
Rangolength ≤ 64
bucket*string
Rango1 ≤ length ≤ 255
path?string

Object key (input) or destination key prefix (output)

Rangolength ≤ 1024Por defecto""
access_key?string | null
Rangolength ≤ 255
secret_key?string | null
Rangolength ≤ 2048
output*JobOutput
Propiedades (1)
s3*S3Config
Propiedades (6)
endpoint?string | null

S3-compatible endpoint URL (omit for AWS S3)

Rangolength ≤ 512
region?string | null
Rangolength ≤ 64
bucket*string
Rango1 ≤ length ≤ 255
path?string

Object key (input) or destination key prefix (output)

Rangolength ≤ 1024Por defecto""
access_key?string | null
Rangolength ≤ 255
secret_key?string | null
Rangolength ≤ 2048
outputs*array<OutputSpec>
Rangoitems ≥ 1Rangoitems ≤ 20
Propiedades (1)
type*string
Valores"file""hls""thumbnails""gif"
webhook_url?string | null
Rangolength ≤ 2048
idempotency_key?string | null
Rangolength ≤ 255

Respuestas

Successful Response

application/json

uuid*string
status?string | null

queued, analyzing, encoding, finalizing, completed, failed, canceled

input?record<string, any> | null

Source of the video {source, url, s3}. s3.secret_key is never returned

output?record<string, any> | null

Destination storage {s3}. s3.secret_key is never returned

spec?record<string, any> | null

Requested outputs: {outputs: [OutputSpec, ...]}

outputs?any

Files produced by the job ([{type, bucket, key}]); null until the job finishes

progress?integer | null

Progress percentage (0-100)

total_segments?integer | null
completed_segments?integer | null
batch_id?string | null

Set when the job was created through a bulk submission

error?string | null
created_at?string | null